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.

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

Weitere Informationen

IMFMediaTypeHandler