IAudioEndpointVolumeCallback::OnNotify メソッド (endpointvolume.h)

OnNotify メソッドは、オーディオ エンドポイント デバイスのボリューム レベルまたはミュート状態が変更されたことをクライアントに通知します。

構文

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

パラメーター

[in] pNotify

ボリューム通知データへのポインター。 このパラメーターは、 AUDIO_VOLUME_NOTIFICATION_DATA型の構造体を指します。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合はエラー コードを返します。

解説

pNotify パラメーターは、OnNotify の呼び出しを開始したボリューム変更イベントを記述する構造体を指します。 この構造体には、イベント コンテキスト GUID が含まれています。 この GUID を使用すると、クライアントは、開始したボリューム (またはミュート) の変更と、他のクライアントが開始した変更を区別できます。 ストリームのボリューム レベルを変更する IAudioEndpointVolume メソッドを呼び出すと、クライアントは 、OnNotify メソッドの実装で認識できるイベント コンテキスト GUID へのポインターを渡します。 pNotify によって指される構造体には、このコンテキスト GUID が含まれています。 ボリューム レベルを変更するクライアントが、イベント コンテキスト GUID へのポインターに NULL ポインター値を提供する場合、 pNotify が指す構造体内のイベント コンテキスト GUID の値はGUID_NULL。

システムのボリューム ユーザー インターフェイスである Windows 7 では、システム内のボリュームを変更するときにGUID_NULLを指定しません。 サードパーティ OSD アプリケーションでは、システムのボリューム ユーザー インターフェイスに起因するマスター ボリューム制御の変更と、組み込みのボリューム制御ハンドラーからの変更などの他のボリューム変更を区別できます。

OnNotify メソッドを実装するコード例については、「Endpoint Volume Controls」を参照してください。

要件

こちらもご覧ください

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume インターフェイス

IAudioEndpointVolumeCallback インターフェイス