다음을 통해 공유

IAudioMediaType::IsEqual 메서드(audiomediatype.h)

  • 아티클

메서드는 IsEqual 두 미디어 형식을 비교하고 동일한지 여부를 결정합니다.

구문

HRESULT IsEqual(
  [in]  IAudioMediaType *pIAudioType,
  [out] DWORD           *pdwFlags
);

매개 변수

[in] pIAudioType

비교할 미디어 형식의 IAudioMediaType 인터페이스에 대한 포인터를 지정합니다.

[out] pdwFlags

0개 이상의 플래그의 비트 OR 결과를 포함하는 DWORD 변수에 대한 포인터를 지정합니다. 이러한 플래그는 두 미디어 형식 간의 유사성 정도를 나타냅니다. 다음 표에서는 지원되는 플래그를 보여줍니다.

플래그 의미
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES 오디오 형식 유형은 동일합니다.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA 형식 정보는 기본 WAVEFORMATEX 구조 이외의 추가 데이터를 포함하지 않고 일치합니다.
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA 추가 데이터가 동일하거나 미디어 형식에 추가 데이터가 포함되지 않습니다.

반환 값

메서드는 IsEqual 성공하면 S_OK 반환하고, 그렇지 않으면 다음 표에 표시된 HRESULT 값 중 하나를 반환합니다.

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

설명

두 미디어 형식 모두 주 형식이어야 합니다. 그렇지 않으면 메서드가 E_INVALIDARG 반환합니다. 미디어 유형에 대한 자세한 내용은 미디어 형식을 참조하세요.

MF_MEDIATYPE_EQUAL_FORMAT_DATA 플래그는 두 미디어 형식이 호환되는 특성을 가지고 있음을 나타내지만, 하나는 다른 미디어 형식의 상위 집합일 수 있습니다. 이 비교 방법은 부분적으로 지정된 미디어 형식을 전체 미디어 형식과 비교할 수 있음을 의미합니다. 예를 들어 동일한 형식을 설명하는 두 개의 비디오 형식이 있을 수 있지만 한 형식에는 확장된 색 정보(크로마 배치, 명목 범위 등)에 대한 특성이 포함됩니다.

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

요구 사항

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

추가 정보

IAudioMediaType

미디어 유형

WAVEFORMATEX