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	Success
AUDCLNT_E_DEVICE_INVALIDATED	오디오 클라이언트와 연결된 오디오 디바이스가 무효화되었습니다.

설명

이 메서드에서 반환된 값을 사용하여 원본 버퍼를 할당할 수 있습니다. 엔드포인트 주기가 변경되면 이 값이 변경됩니다. 호출자는 스트림을 만들 때 사용할 동일한 AUDIO_STREAM_CATEGORY 및 WAVEFORMATEX 값을 지정해야 합니다. SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD 플래그를 사용하여 스트림을 만들 경우 offloadEnabled 매개 변수를 TRUE로 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 빌드 22000
머리글	spatialaudioclient.h