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 반환합니다. 그렇지 않으면 다음 표에 표시된 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
함수에 전달된 포인터가 잘못되었습니다. |
|
반환 버퍼를 할당할 수 없음 |
|
nFormat이 범위를 벗어났습니다. |
설명
sAPO는 CoTaskMemAlloc 을 사용하여 반환된 문자열을 할당합니다. 호출자는 CoTaskMemFree 를 사용하여 ppwstrFormatRep 매개 변수가 가리키는 버퍼를 삭제해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | audioenginebaseapo.h(Audioenginebaseapo.h 포함) |
| IRQL | 모든 수준. |