IAudioProcessingObjectPreferredFormatSupport::GetPreferredInputFormat 메서드(audioengineextensionapo.h)

API가 제공된 출력 형식에 대한 기본 입력 형식을 지정할 수 있도록 하는 콜백 함수입니다.

구문

HRESULT GetPreferredInputFormat(
  [in]  IAudioMediaType *outputFormat,
  [out] IAudioMediaType **preferredFormat
);

매개 변수

[in] outputFormat

콜백과 연결된 출력 형식을 나타내는 IAudioMediaType 입니다.

[out] preferredFormat

APO의 기본 입력 형식을 나타내는 IAudioMediaType 입니다.

반환 값

Hresult.

설명

이 API를 사용하면 가상 서라운드 사운드를 제공하는 헤드폰 공급자와 같은 시나리오를 사용할 수 있습니다. APO는 엔드포인트가 스테레오로 렌더링되더라도 7-1 입력을 받도록 요청할 수 있습니다. API는 다른 출력 형식에 대해 서로 다른 기본 설정 형식을 지정할 수 있습니다. 예를 들어 m 스트림 형식이 미디어일 때 앱에서 7.1 입력을 요청할 수 있지만 스트림 형식이 통신일 때 스테레오 입력을 요청할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11 버전 23H2
머리글	audioengineextensionapo.h