IAudioMediaType：：IsEqual 方法 (audiomediatype.h)

方法 IsEqual 會比較兩種媒體類型，並判斷它們是否相同。

語法

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

[in] pIAudioType

指定要比較之媒體類型的 IAudioMediaType 介面指標。

[out] pdwFlags

指定 DWORD 變數的指標，其中包含零個或多個旗標的位 OR 結果。這些旗標表示兩種媒體類型之間的相似度。下表顯示支援的旗標。

旗標	意義
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES	音訊格式類型相同。
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA	格式資訊相符，不包括基底的顯示格式資訊以外的額外數據。
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA	額外的數據相同，或媒體類型都不包含額外的數據。

如果方法成功，方法 IsEqual 會傳回S_OK，否則會傳回下表所示的其中一個 HRESULT 值。

傳回碼	Description
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	所有層級。