IMFMediaTypeHandler::SetCurrentMediaType-Methode (mfidl.h)
Legt den Medientyp des Objekts fest.
Syntax
HRESULT SetCurrentMediaType(
[in] IMFMediaType *pMediaType
);
Parameter
[in] pMediaType
Zeiger auf die IMFMediaType-Schnittstelle des neuen Medientyps.
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. |
|
Ungültige Anforderung. |
Hinweise
Für Medienquellen bedeutet das Festlegen des Medientyps, dass die Quelle Daten generiert, die diesem Medientyp entsprechen. Bei Mediensenken bedeutet das Festlegen des Medientyps, dass die Senke Daten empfangen kann, die diesem Medientyp entsprechen.
Jede Implementierung dieser Methode sollte überprüfen, ob sich pMediaType vom aktuellen Medientyp des Objekts unterscheidet. Wenn die Typen identisch sind, sollte die Methode S_OK zurückgeben, aber vermeiden, ressourcen unnötig freizugeben und neu zu erstellen. Wenn die Typen nicht identisch sind, sollte die Methode den neuen Typ überprüfen.
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.
Anforderungen
| 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 |