IMMNotificationClient::OnDeviceStateChanged

  • Article
Previous Next

IMMNotificationClient::OnDeviceStateChanged

The OnDeviceStateChanged method indicates that the state of an audio endpoint device has changed.

HRESULT OnDeviceStateChanged(
  LPCWSTR  pwstrDeviceId,
  DWORD  dwNewState
);

Parameters

pwstrDeviceId

[in]  Pointer to the endpoint ID string that identifies the audio endpoint device. This parameter points to a null-terminated, wide-character string containing the endpoint ID. The string remains valid for the duration of the call.

dwNewState

[in]  Specifies the new state of the endpoint device. The value of this parameter is one of the following DEVICE_STATE_XXX constants:

DEVICE_STATE_ACTIVE

DEVICE_STATE_DISABLED

DEVICE_STATE_NOTPRESENT

DEVICE_STATE_UNPLUGGED

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

For a code example that implements the OnDeviceStateChanged method, see Device Events.

Requirements

Client: Windows Vista

Header: Include Mmdeviceapi.h.

See Also

Previous Next