Поделиться через


Метод 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 , которые будут использоваться при создании потока. Параметру offloadEnabled необходимо задать значение TRUE, если поток будет создан с флагом SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD.

Требования

Требование Значение
Минимальная версия клиента Сборка Windows 22000
Верхняя часть spatialaudioclient.h