IMMNotificationClient::OnDeviceStateChanged 方法 (mmdeviceapi.h)
OnDeviceStateChanged方法表示音訊端點裝置的狀態已變更。
語法
HRESULT OnDeviceStateChanged(
[in] LPCWSTR pwstrDeviceId,
[in] DWORD dwNewState
);
參數
[in] pwstrDeviceId
識別音訊端點裝置的 端點識別碼字串 指標。 此參數指向包含端點識別碼的 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 |