IMFMediaTypeHandler::IsMediaTypeSupported-Methode (mfidl.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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.
- 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 |