Skip to main content

IAudioStateMonitor 介面

提供方法,讓桌面應用程式和遊戲探索其音訊串流的音量層級何時被系統修改。這包括下列案例:
  • 得知遊戲媒體串流何時因為音訊應用程式正在背景中播放而被靜音,或
  • 得知何時因為 VOIP 通話已在背景中開始而應停止遊戲聊天音訊串流。
提供方法,讓桌面應用程式和遊戲判斷其音訊串流的音量層級被系統修改的時間。這包括遊戲或應用程式需要判斷下列項目的案例:
  • 遊戲媒體串流因為音訊應用程式正在背景中播放而被靜音的時間
  • 因為 VoIP 通話已在背景中開始而應停止遊戲聊天音訊串流的時間
可以檢查並監視轉譯串流和擷取串流的音量層級。可依類別、音訊端點或裝置角色選取要監視的串流。在建立新串流之前,即可檢查該串流將會具有的音量層級。 此 API 相當於 Windows.Media.Audio.AudiostateMonitor 類別,該類別可供 UWP 應用程式使用,但不適用於桌面應用程式和遊戲。UWP 應用程式無法使用此介面。

成員

IAudioStateMonitor 介面繼承自 IUnknown 介面,但也具有下列類型的成員:

方法

IAudioStateMonitor 介面具有下列方法:

備註

若要取得此介面的執行個體,請呼叫下列其中一個方法: 下列範例程式碼示範的案例是:遊戲針對其在 AudioCategory_GameMedia 類別中的音訊轉譯串流註冊音訊層級通知。 如果此類別的音量層級為靜音,遊戲會停止播放其遊戲媒體串流。如果音量層級設定為其他任何值,則會播放遊戲媒體串流。

需求

標頭: Audiostatemonitorapi.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

關於 WASAPI
Last modified on October 6, 2026