ISpatialAudioClient2::GetMaxFrameCountForCategory 方法 (spatialaudioclient.h)
获取每个处理过程支持的最大帧计数。
语法
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
指向 WAVEFORMATEX 的指针 (mmeapi.h) 结构,用于指定查询其支持的音频流的格式。
[out] frameCountPerBuffer
接收指向 INT32 的指针,指示音频设备支持的最大帧计数和指定的输入参数。
返回值
包含以下值的 HRESULT。
值 | 说明 |
---|---|
S_OK | 成功 |
AUDCLNT_E_DEVICE_INVALIDATED | 与音频客户端关联的音频设备已失效。 |
注解
此方法返回的值可用于分配源缓冲区。 如果终结点节奏发生更改,此值将更改。 调用方必须指定创建流时将使用 的相同AUDIO_STREAM_CATEGORY 和 WAVEFORMATEX 值。 如果将使用 SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD 标志创建流,则必须将 offloadEnabled 参数设置为 TRUE。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 内部版本 22000 |
标头 | spatialaudioclient.h |