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