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

메서드는 GetFormatRepresentation 사용자 인터페이스에 표시될 수 있도록 사용자 지정 형식의 문자열 표현을 검색합니다.

구문

HRESULT GetFormatRepresentation(
  [in]            UINT   nFormat,
  [out, optional] LPWSTR *ppwstrFormatRep
);

매개 변수

[in] nFormat

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

[out, optional] ppwstrFormatRep

사용자 지정 형식을 설명하는 NULL로 종료된 유니코드 문자열을 수신하는 버퍼의 주소를 지정합니다.

반환 값

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

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

설명

sAPO는 CoTaskMemAlloc 을 사용하여 반환된 문자열을 할당합니다. 호출자는 CoTaskMemFree 를 사용하여 ppwstrFormatRep 매개 변수가 가리키는 버퍼를 삭제해야 합니다.

요구 사항

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

추가 정보

CoTaskMemAlloc

CoTaskMemFree

GetFormatCount