Skip to main content

IAudioStateMonitor 接口

提供各种方法,让桌面应用和游戏能够发现其音频流的音量级别何时被系统修改。这包括以下场景:
  • 当音频应用在后台播放时,得知游戏媒体流何时被静音;或
  • 当 VOIP 通话在后台开始时,得知何时应停止游戏聊天音频流。
提供各种方法,让桌面应用和游戏能够确定其音频流的音量级别何时被系统修改。这包括以下场景:游戏或应用需要确定以下信息:
  • 因音频应用在后台播放而游戏媒体流被静音的时间点
  • 因 VoIP 通话在后台开始而应停止游戏聊天音频流的时间点
可以对呈现流和捕获流的音量级别进行检查和监视。可按类别、音频终结点或设备角色来选择要监视的流。可在创建新流之前先检查该流将具有的音量级别。 此 API 等同于 Windows.Media.Audio.AudiostateMonitor 类;该类可供 UWP 应用使用,但不适用于桌面应用和游戏。UWP 应用无法使用此接口。

Members

IAudioStateMonitor 接口继承自 IUnknown 接口,同时还具有以下类型的成员:

Methods

IAudioStateMonitor 接口具有以下方法:

Remarks

若要获取此接口的实例,请调用下列方法之一: 以下示例代码演示了这样一个场景:游戏为其 AudioCategory_GameMedia 类别中的音频呈现流注册音频级别通知。 如果此类别的音量级别为静音,则游戏将停止播放其游戏媒体流。如果音量级别设为任何其他值,则播放该游戏媒体流。

Requirements

头文件: Audiostatemonitorapi.h 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

See also

关于 WASAPI
最后修改于 2026年8月24日