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 接口