IMFMediaTypeHandler::SetCurrentMediaType-Methode (mfidl.h)

  • Artikel

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
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDREQUEST
 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

Weitere Informationen

IMFMediaTypeHandler