Skip to main content

IAudioStateMonitor インターフェイス

デスクトップ アプリやゲームが、自身のオーディオ ストリームのサウンド レベルがシステムによって変更されるタイミングを検出するためのメソッドを提供します。次のようなシナリオが含まれます。
  • ゲーム メディア ストリームが、バックグラウンドで再生されているオーディオ アプリによってミュートされたタイミングを知りたい場合
  • バックグラウンドで VOIP 通話が始まったために、ゲーム チャットのオーディオ ストリームを停止すべきタイミングを知りたい場合
デスクトップ アプリやゲームが、自身のオーディオ ストリームのサウンド レベルがシステムによって変更された時刻を把握するためのメソッドを提供します。ゲームまたはアプリが以下を判断する必要があるシナリオが含まれます。
  • バックグラウンドで再生されているオーディオ アプリによってゲーム メディア ストリームがミュートされた時刻
  • バックグラウンドで VoIP 通話が開始されたためにゲーム チャットのオーディオ ストリームを停止する時刻
サウンド レベルは、レンダー ストリームだけでなくキャプチャ ストリームについても確認および監視できます。監視対象のストリームは、カテゴリ、オーディオ エンドポイント、またはデバイス ロールによって選択できます。新しいストリームを作成する前に、そのストリームが取り得るサウンド レベルを事前に確認することもできます。 この API は、UWP アプリで使用可能な Windows.Media.Audio.AudiostateMonitor クラス と同等のものですが、デスクトップ アプリやゲーム向けのものです。このインターフェイスは UWP アプリでは使用できません。

メンバー

IAudioStateMonitor インターフェイスは IUnknown インターフェイスを継承していますが、次のような種類のメンバーも持っています。

メソッド

IAudioStateMonitor インターフェイスには次のメソッドがあります。

解説

このインターフェイスのインスタンスを取得するには、以下のいずれかのメソッドを呼び出します。 次のコード例では、ゲームが AudioCategory_GameMedia カテゴリのオーディオ レンダー ストリームに対してオーディオ レベル通知を登録するシナリオを示します。 このカテゴリのサウンド レベルがミュートされている場合、ゲームは自身のゲーム メディア ストリームの再生を停止します。サウンド レベルがそれ以外の値に設定されている場合は、ゲーム メディア ストリームが再生されます。

要件

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

関連項目

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