获取每个处理传递支持的最大帧计数。
Syntax
HRESULT GetMaxFrameCountForCategory(
[in] AUDIO_STREAM_CATEGORY category,
[in] BOOL offloadEnabled,
[in] const WAVEFORMATEX *objectFormat,
[out] UINT32 *frameCountPerBuffer
);
参数
[in] category
为其查询支持的音频流的 AUDIO_STREAM_CATEGORY (audiosessiontypes.h)。
[in] offloadEnabled
一个布尔值,该值指定是否应使用考虑音频卸载支持计算返回的帧计数。 如果此标志设置为 true,则返回的帧计数是激活流以卸载模式时会执行的作。 但是,如果此标志设置为 true,但音频终结点不支持卸载模式,则标志不起作用。 使用 ISpatialAudioClient2::IsOffloadCapable 检查是否支持卸载模式。
[in] objectFormat
指向 波形图X(mmeapi.h) 结构的指针,指定查询其支持的音频流的格式。
[out] frameCountPerBuffer
接收指向 INT32 的指针,指示音频设备和指定输入参数支持的最大帧计数。
返回值
HRESULT,包括以下值。
| 价值 | Description |
|---|---|
| S_OK | 成功 |
| AUDCLNT_E_DEVICE_INVALIDATED | 与音频客户端关联的音频设备已失效。 |
注解
此方法返回的值可用于分配源缓冲区。 如果终结点节奏发生更改,此值将更改。 调用方必须指定创建流时将使用的相同 AUDIO_STREAM_CATEGORY 和 WAVEFORMATEX 值。 如果使用SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD标志创建流,则必须将 offloadEnabled 参数设置为 TRUE。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 内部版本 22000 |
| Header | spatialaudioclient.h |