IApoAuxiliaryInputConfiguration::IsInputFormatSupported 메서드(audioenginebaseapo.h)

특정 보조 입력 형식이 APO에서 지원되는지 확인합니다.

구문

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

pRequestedInputFormat

확인할 입력 형식입니다.

ppSupportedInputFormat

APO는 이 매개 변수를 메서드에 전달된 형식에 가장 가까운 지원되는 입력 형식으로 채웁니다.

HRESULT

HRESULT	설명
S_OK	완료되었습니다. APO는 pRequestedInputFormat에 대한 참조를 추가하고 ppSupportedInputFormat으로 반환해야 합니다.
S_FALSE	형식은 지원되지 않습니다. APO는 제안된 지원되는 형식을 ppSupportedInputFormat으로 반환해야 합니다.
APOERR_FORMAT_NOT_SUPPORTED	형식은 지원되지 않습니다. APO는 ppSupportedInputFormat을 수정해서는 안 됩니다.
E_POINTER	이 함수에 전달된 포인터가 잘못되었습니다.
기타 값	다른 구성 요소로 인해 오류가 발생합니다. 이러한 오류는 시스템에서 추적합니다.

APO가 요청된 형식을 수락할 수 있는 경우 요청된 형식에 대한 참조를 추가하고, 지원되는 출력 형식으로 반환하고, S_OK 반환해야 합니다.

APO가 요청된 형식을 수락할 수 없는 경우 대체 요청된 형식을 제안할 수 있습니다. 이 경우 제안된 형식을 만들고 반환하고 S_FALSE 반환해야 합니다.

반환된 지원되는 형식은 요청된 형식에 '가장 가까운' 형식이어야 합니다. 즉, 형식은 우선 순위 순서로 지정된 다음 속성에 대해 동일한 값을 가져야 합니다.

제안된 형식은 S_FALSE 반환되는 경우에만 요청된 형식과 다를 수 있습니다. 오류를 반환할 때 제안된 형식은 그대로 두어야 합니다.

이 API는 언제든지 호출될 수 있습니다. 반환된 결과는 외부 사용자 인터페이스에서 조작할 수 있는 APO의 내부 상태에 따라 달라집니다. 그러나 처리를 위해 APO가 잠기면 이 형식은 변경할 수 없으며 변경되지 않습니다.

이 메서드는 실시간 처리 스레드에서 호출할 수 없습니다.

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