IMMNotificationClient::OnDeviceStateChanged メソッド (mmdeviceapi.h)

OnDeviceStateChanged メソッドは、オーディオエンドポイントデバイスの状態が変更されたことを示します。

構文

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

[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 メソッドを実装するコード例については、「デバイスイベント」を参照してください。