ISpatialAudioClient2::GetMaxFrameCountForCategory 方法(spatialaudioclient.h)

获取每个处理传递支持的最大帧计数。

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_CATEGORYWAVEFORMATEX 值。 如果使用SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD标志创建流,则必须将 offloadEnabled 参数设置为 TRUE。

要求

Requirement 价值
最低支持的客户端 Windows 内部版本 22000
Header spatialaudioclient.h