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

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmdeviceapi.h

関連項目

IMMNotificationClient インターフェイス