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

두 미디어 형식을 비교하고 동일한지 여부를 결정합니다. 이 형식이 동일하지 않으면 메서드는 두 형식의 차이점을 나타냅니다.

구문

HRESULT IsEqual(
  [in]  IMFMediaType *pIMediaType,
  [out] DWORD        *pdwFlags
);

[in] pIMediaType

비교할 미디어 형식의 IMFMediaType 인터페이스에 대한 포인터입니다.

[out] pdwFlags

두 미디어 형식 간의 유사성 정도를 나타내는 0개 이상의 플래그의 비트 OR 을 받습니다. 다음 플래그가 정의됩니다.

값	의미
MF_MEDIATYPE_EQUAL_MAJOR_TYPES 0x00000001	주 형식은 동일합니다. 주 형식은 MF_MT_MAJOR_TYPE 특성으로 지정됩니다.
MF_MEDIATYPE_EQUAL_FORMAT_TYPES 0x00000002	하위 형식은 동일하거나 미디어 형식에 하위 형식이 없습니다. 하위 형식은 MF_MT_SUBTYPE 특성으로 지정됩니다.
MF_MEDIATYPE_EQUAL_FORMAT_DATA 0x00000004	미디어 형식 중 하나의 특성은 다른 특성의 하위 집합이며 이러한 특성의 값은 MF_MT_USER_DATA, MF_MT_FRAME_RATE_RANGE_MIN 및 MF_MT_FRAME_RATE_RANGE_MAX 특성의 값을 제외하고 일치합니다. 특히 메서드는 더 적은 수의 특성을 가진 미디어 형식을 사용하고 해당 형식의 각 특성이 다른 미디어 형식에 있는지 확인하고 동일한 값( MF_MT_USER_DATA, MF_MT_FRAME_RATE_RANGE_MIN 및 MF_MT_FRAME_RATE_RANGE_MAX 제외)을 포함합니다. 다른 비교를 수행하려면 IMFAttributes::Compare 메서드를 사용합니다. 예를 들어 Compare 메서드는 동일한 특성을 테스트하거나 두 특성 집합의 교차를 테스트할 수 있습니다. 자세한 내용은 MF_ATTRIBUTES_MATCH_TYPE 참조하세요.
MF_MEDIATYPE_EQUAL_FORMAT_USER_DATA 0x00000008	사용자 데이터가 동일하거나 미디어 형식에 사용자 데이터가 포함되지 않습니다. 사용자 데이터는 MF_MT_USER_DATA 특성으로 지정됩니다.

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

반환 코드	설명
S_FALSE	형식이 같지 않습니다. pdwFlags 매개 변수를 검사하여 형식의 차이점을 확인합니다.
S_OK	형식은 같습니다.
E_INVALIDARG	하나 또는 두 미디어 유형이 잘못되었습니다.

두 미디어 형식 모두 주 형식이거나 메서드가 E_INVALIDARG 반환해야 합니다.

메서드가 성공하고 모든 비교 플래그가 pdwFlags로 설정된 경우 반환 값은 S_OK. 메서드가 성공하지만 하나 이상의 비교 플래그가 설정되지 않은 경우 메서드는 S_FALSE 반환합니다.

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