CreateRenderAudioStateMonitorForCategoryAndDeviceId

[部分信息涉及预发布产品,在其正式发布之前可能会发生重大更改。对于此处提供的信息,Microsoft 不作任何明示或默示的担保。] 创建 IAudioStateMonitor 的新实例,用于监视指定类别中、具有指定 device ID 的音频终结点上所有音频呈现流的音频级别。

Syntax

HRESULT WINAPI CreateRenderAudioStateMonitorForCategoryAndDeviceId(
  AUDIO_STREAM_CATEGORY category,
  PCWSTR deviceId,
  _Out_ IAudioStateMonitor **audioStateMonitor
);

Parameters

category
Type: AUDIO_STREAM_CATEGORY AUDIO_STREAM_CATEGORY 枚举的一个成员,用于指定要监视的音频呈现流的类别。 deviceId
Type: PCWSTR 指定要监视其音频呈现流的音频终结点的 device ID。 audioStateMonitor _Out_
Type: IAudioStateMonitor** 此输出参数将填充所创建的 IAudioStateMonitor 对象。

Return value

Type: HRESULT 如果方法成功,则返回 S\_OK。

Remarks

这是用于创建并返回 AudioStateMonitor 实例的其中一个函数。对于捕获流和呈现流,各有四个变体,用于确定进程是否可以针对给定角色执行以下操作之一:

捕获或呈现任意类别的任意音频
捕获或呈现特定类别的音频
将特定类别的音频捕获或呈现到特定终结点。
终结点可以通过 MMDevice ID(使用 IMMDevice::GetId() 获取)指定,也可以通过其 SWD ID(使用 Windows.Devices.Enumeration 或 Windows.Media.Devices.MediaDevice 获取)指定
将特定类别的音频捕获或呈现到默认终结点

Requirements

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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

CreateRenderAudioStateMonitorForCategoryAndDeviceId

CreateRenderAudioStateMonitorForCategoryAndDeviceId

Syntax

Parameters

Return value

Remarks

Requirements

See also

​CreateRenderAudioStateMonitorForCategoryAndDeviceId

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

CreateRenderAudioStateMonitorForCategoryAndDeviceId

Syntax

Parameters

Return value

Remarks

Requirements

See also