Skip to main content

IAudioStateMonitor::RegisterCallback メソッド

IAudioStateMonitor に関連付けられているストリームのオーディオ レベルが変化したときにシステムから呼び出されるコールバック関数を登録します。

構文

パラメーター

callback
型: AudioStateMonitorCallback*
IAudioStateMonitor に関連付けられているストリームのオーディオ レベルに変化があったときに、システムによって呼び出されるコールバック関数へのポインターです。 context
型: void*
callback パラメーターで指定した関数に渡される、アプリ定義のコンテキスト データへのポインターです。 registration [out]
型: AudioStateMonitorRegistration*
コールバック登録を識別する 64 ビット整数です。callback パラメーターで指定した関数の登録を解除するには、この値を IAudioStateMonitor::UnregisterCallback に渡します。

戻り値

型: HRESULT メソッドが成功した場合、S_OK が返されます。失敗した場合、返されるコードには次の表に示す値が含まれますが、これらに限定されません。

解説

次のシナリオを考えてみます。ゲームが、OS のポリシーによってオーディオがミュートされないことがわかっている場合にのみ GameMedia オーディオを再生するとします。これを実現するために、ゲームは既定のコンソール エンドポイントの AudioCategory_GameMedia ストリーム カテゴリに対して SoundLevel 通知を登録します。このカテゴリの SoundLevel が ‘Muted’ に設定されている場合、ゲームは GameMedia ストリームの再生を停止します。SoundLevel がそれ以外の値に設定されている場合、ゲームは GameMedia ストリームを再生します。

要件

ヘッダー: Audiostatemonitorapi.h サポートされるプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

関連項目

IAudioStateMonitor WASAPI について
最終更新日 2026年8月24日