Skip to main content

IAudioStateMonitor::GetSoundLevel メソッド

[一部の情報は、市販前に大幅に変更される可能性のあるプレリリース製品に関するものです。Microsoft は、ここに記載されている情報に関して、明示または黙示のいかなる保証も行いません。] IAudioStateMonitor に関連付けられているストリームの現在のサウンド レベルを取得します。

構文

パラメーター

このメソッドにはパラメーターはありません。

戻り値

IAudioStateMonitor に関連付けられているストリームの現在のサウンド レベルを示す、AudioStateMonitorSoundLevel 列挙型の値です。

解説

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

要件

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

関連項目

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