IMFMediaType::GetRepresentation 메서드(mfobjects.h)

미디어 형식의 대체 표현을 검색합니다. 현재 DirectShow AM_MEDIA_TYPE 구조만 지원됩니다.

구문

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

[in] guidRepresentation

검색할 표현을 지정하는 GUID입니다. 다음 값이 정의됩니다.

값	의미
AM_MEDIA_TYPE_REPRESENTATION	미디어 형식을 DirectShow AM_MEDIA_TYPE 구조체로 변환합니다. 메서드는 가장 적합한 형식 구조체(pbFormat)를 선택합니다.
FORMAT_MFVideoFormat	MFVIDEOFORMAT 형식 구조를 사용하여 미디어 형식을 DirectShow AM_MEDIA_TYPE 구조체로 변환합니다.
FORMAT_VideoInfo	VIDEOINFOHEADER 형식 구조를 사용하여 미디어 형식을 DirectShow AM_MEDIA_TYPE 구조체로 변환합니다.
FORMAT_VideoInfo2	미디어 형식을 VIDEOINFOHEADER2 형식 구조로 DirectShow AM_MEDIA_TYPE 구조체로 변환합니다.

[out] ppvRepresentation

표현을 포함하는 구조체에 대한 포인터를 받습니다. 메서드는 구조체에 대한 메모리를 할당합니다. 호출자는 IMFMediaType::FreeRepresentation을 호출하여 메모리를 해제해야 합니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_ATTRIBUTENOTFOUND	미디어 형식의 세부 정보가 요청된 표현과 일치하지 않습니다.
MF_E_INVALIDMEDIATYPE	미디어 유형이 잘못되었습니다.
MF_E_UNSUPPORTED_REPRESENTATION	미디어 형식은 요청된 표현을 지원하지 않습니다.

GUIDRepresentation 매개 변수(예: VIDEOINFOHEADER)에서 특정 형식 구조를 요청하는 경우 일부 형식 정보가 손실될 수 있습니다.

MFInitAMMediaTypeFromMFMediaType 함수를 사용하여 Media Foundation 미디어 형식을 DirectShow 미디어 형식으로 변환할 수도 있습니다.

이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

WINDOWS XP SP2(서비스 팩 2) 이상
KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)이 설치된 Windows XP Media Center Edition 2005.