IAudioMediaType::IsEqual-Methode (audiomediatype.h)

Die IsEqual -Methode vergleicht zwei Medientypen und bestimmt, ob sie identisch sind.

Syntax

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

Parameter

[in] pIAudioType

Gibt einen Zeiger auf eine IAudioMediaType-Schnittstelle des zu vergleichenden Medientyps an.

[out] pdwFlags

Gibt einen Zeiger auf eine DWORD-Variable an, die das bitweise OR-Ergebnis von null oder mehr Flags enthält. Diese Flags geben den Grad der Ähnlichkeit zwischen den beiden Medientypen an. In der folgenden Tabelle sind die unterstützten Flags aufgeführt.

Flag Bedeutung
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES Die Audioformattypen sind identisch.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA Die Formatinformationen entsprechen, ohne zusätzliche Daten, die über die WAVEFORMATEX-Basisstruktur hinausgehen.
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA Die zusätzlichen Daten sind identisch, oder keiner der Medientypen enthält zusätzliche Daten.

Rückgabewert

Die IsEqual Methode gibt S_OK zurück, wenn sie erfolgreich ist, andernfalls wird einer der in der folgenden Tabelle gezeigten HRESULT-Werte zurückgegeben.

Rückgabecode Beschreibung
E_INVALIDARG
Ein Medientyp ist ungültig, oder beide Medientypen sind ungültig.
S_FALSE
Die Medientypen sind ungleich. Untersuchen Sie den pdwFlags-Parameter , um zu bestimmen, wie sich die Medientypen unterscheiden.

Hinweise

Beide Medientypen müssen über einen Haupttyp verfügen, andernfalls gibt die Methode E_INVALIDARG zurück. Weitere Informationen zu Medientypen finden Sie unter Medientypen.

Das MF_MEDIATYPE_EQUAL_FORMAT_DATA-Flag gibt an, dass beide Medientypen über kompatible Attribute verfügen, obwohl eines möglicherweise eine Übermenge des anderen ist. Diese Vergleichsmethode bedeutet, dass Sie einen teilweise angegebenen Medientyp mit einem vollständigen Medientyp vergleichen können. Beispielsweise können Sie über zwei Videotypen verfügen, die dasselbe Format beschreiben, aber ein Typ enthält Attribute für erweiterte Farbinformationen (Chroma-Sitz, Nominalbereich usw.).

Wenn die Methode erfolgreich ist und alle Vergleichsflags in pdwFlags festgelegt sind, wird der Rückgabewert S_OK. Wenn die Methode erfolgreich ist, aber einige Vergleichsflags nicht festgelegt sind, gibt die Methode S_FALSE zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform Desktop
Kopfzeile audiomediatype.h (include Audiomediatype.h)
IRQL Alle Ebenen.

Weitere Informationen

IAudioMediaType

Medientypen

WAVEFORMATEX