IMMNotificationClient::OnDeviceStateChanged 方法 (mmdeviceapi.h)

OnDeviceStateChanged 方法指示音频终结点设备的状态已更改。

语法

HRESULT OnDeviceStateChanged(
  [in] LPCWSTR pwstrDeviceId,
  [in] DWORD   dwNewState
);

parameters

[in] pwstrDeviceId

指向标识音频 终结点设备的终结点 ID 字符串 的指针。 此参数指向包含终结点 ID 的以 null 结尾的宽字符字符串。 字符串在调用期间保持有效。

[in] dwNewState

指定终结点设备的新状态。 此参数的值是下列 DEVICE_STATE_XXX 常量之一:

DEVICE_STATE_ACTIVE

DEVICE_STATE_DISABLED

DEVICE_STATE_NOTPRESENT

DEVICE_STATE_UNPLUGGED

返回值

如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。

注解

有关实现 OnDeviceStateChanged 方法的 代码示例,请参阅 设备事件

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mmdeviceapi.h

另请参阅

IMMNotificationClient 接口