IAudioSystemEffectsCustomFormats::GetFormat 메서드(audioenginebaseapo.h)

메서드는 GetFormat 사용자 지정 형식의 IAudioMediaType 표현을 검색합니다.

구문

HRESULT GetFormat(
  [in]            UINT            nFormat,
  [out, optional] IAudioMediaType **ppFormat
);

매개 변수

[in] nFormat

지원되는 형식의 인덱스를 지정합니다. 이 매개 변수는 GetFormatCount의 반환 값보다 0부터 1까지 범위의 모든 값일 수 있습니다. 즉, 범위의 모든 값이 0에서 GetFormatCount( ) - 1까지입니다.

[out, optional] ppFormat

IAudioMediaType 인터페이스에 대한 포인터에 대한 포인터를 지정합니다. ppFormat 매개 변수가 가리키는 IAudioMediaType 인터페이스를 해제하는 것은 호출자의 책임입니다.

반환 값

메서드는 GetFormat 호출이 성공하면 S_OK 반환합니다. 그렇지 않으면 다음 표에 표시된 오류 코드 중 하나를 반환합니다.

반환 코드	설명
E_POINTER	함수에 전달된 포인터가 잘못되었습니다.
E_OUTOFMEMORY	반환 버퍼를 할당할 수 없음
E_INVALIDARG	nFormat이 범위를 벗어났습니다.

설명

오디오 시스템에서 메서드를 호출하면 GetFormat sAPO는 오디오 미디어 형식 개체를 만들고 IAudioMediaType 인터페이스를 반환합니다. sAPO 구현은 CreateAudioMediaType 유틸리티 함수를 사용하여 오디오 미디어 형식 개체를 만들 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	audioenginebaseapo.h(Audioenginebaseapo.h 포함)
IRQL	모든 수준.

추가 정보

CreateAudioMediaType

GetFormatCount

IAudioMediaType