IMFMediaTypeHandler::IsMediaTypeSupported-Methode (mfidl.h)

  • Artikel

Fragt ab, ob das Objekt einen angegebenen Medientyp unterstützt.

Syntax

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

Parameter

[in] pMediaType

Zeiger auf die IMFMediaType-Schnittstelle des zu überprüfenden Medientyps.

[out] ppMediaType

Empfängt einen Zeiger auf die IMFMediaType-Schnittstelle des am nächsten übereinstimmenden Medientyps oder empfängt den Wert NULL. Wenn nicht NULL, muss der Aufrufer die Schnittstelle freigeben. Dieser Parameter kann NULL sein. Siehe Hinweise.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDMEDIATYPE
 Das -Objekt unterstützt diesen Medientyp nicht.

Hinweise

Wenn das Objekt den in pMediaType angegebenen Medientyp unterstützt, gibt die Methode S_OK zurück. Für eine Medienquelle bedeutet dies, dass die Quelle Daten generieren kann, die diesem Medientyp entsprechen. Für eine Mediensenke bedeutet dies, dass die Senke Daten empfangen kann, die diesem Medientyp entsprechen. Wenn das Objekt den Medientyp nicht unterstützt, schlägt die Methode fehl.

Der ppMediaType-Parameter ist optional. Wenn die Methode fehlschlägt, kann das Objekt ppMediaType verwenden, um einen Medientyp zurückzugeben, der vom Objekt unterstützt wird und der genau mit dem in pMediaType angegebenen typ übereinstimmt. Die -Methode gibt nicht garantiert einen Medientyp in ppMediaType zurück. Wenn kein Typ zurückgegeben wird, empfängt dieser Parameter einen NULL-Zeiger . Wenn die Methode erfolgreich ist, empfängt dieser Parameter einen NULL-Zeiger . Wenn der Aufrufer ppMediaType auf NULL festlegt, wird dieser Parameter ignoriert.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.
Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:
  • Windows XP mit SP2 und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaTypeHandler