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 |
|---|---|
|
Ein Medientyp ist ungültig, oder beide Medientypen sind ungültig. |
|
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. |