Win32 API 日本語リファレンス
ホーム › Media.Audio.Endpoints › IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback

COM
📘 Microsoft Learn (日本語) · English
IID657804fa-d6ad-4496-8a60-352752af4f89継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IAudioEndpointVolumeCallback インターフェースは、オーディオ エンドポイント デバイスの音量レベルおよびミュート状態の変更に関する通知を提供します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT OnNotify(AUDIO_VOLUME_NOTIFICATION_DATA* pNotify)

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

pNotifyAUDIO_VOLUME_NOTIFICATION_DATA*inout音量通知データへのポインター。このパラメーターは、AUDIO_VOLUME_NOTIFICATION_DATA 型の構造体を指します。

戻り値

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

解説(Remarks)

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

Windows 7 では、システムの音量ユーザー インターフェースがシステム内の音量を変更する際に GUID_NULL を指定しません。サードパーティ製の OSD アプリケーションは、システムの音量ユーザー インターフェースによるマスター音量コントロールの変更と、組み込みの音量コントロール ハンドラーによる変更などその他の音量変更とを区別できます。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IAudioEndpointVolumeCallback "{657804FA-D6AD-4496-8A60-352752AF4F89}"
#usecom global IAudioEndpointVolumeCallback IID_IAudioEndpointVolumeCallback "{}"
#comfunc global IAudioEndpointVolumeCallback_OnNotify  3 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。