IMFMediaTypeHandler::GetMediaTypeByIndex 메서드(mfidl.h)

개체의 지원되는 미디어 형식 목록에서 미디어 형식을 검색합니다.

구문

HRESULT GetMediaTypeByIndex(
  [in]  DWORD        dwIndex,
  [out] IMFMediaType **ppType
);

[in] dwIndex

검색할 미디어 형식의 인덱스(0부터 시작)입니다. 목록의 미디어 형식 수를 얻으려면 IMFMediaTypeHandler::GetMediaTypeCount를 호출합니다.

[out] ppType

IMFMediaType 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_NO_MORE_TYPES	dwIndex 매개 변수가 범위를 벗어났습니다.

미디어 형식은 대략적인 기본 설정 순서로 반환됩니다. 지원되는 형식 목록이 완료되는 것은 아닙니다. 특정 미디어 형식이 지원되는지 여부를 테스트하려면 IMFMediaTypeHandler::IsMediaTypeSupported를 호출합니다.

이 인터페이스는 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.