IMFMediaType::GetRepresentation-Methode (mfobjects.h)

  • Artikel

Ruft eine alternative Darstellung des Medientyps ab. Derzeit wird nur die DirectShow-AM_MEDIA_TYPE-Struktur unterstützt.

Syntax

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

Parameter

[in] guidRepresentation

GUID, die die abzurufende Darstellung angibt. Die folgenden Werte werden definiert.

Wert Bedeutung
AM_MEDIA_TYPE_REPRESENTATION
 Konvertieren Sie den Medientyp in eine DirectShow-AM_MEDIA_TYPE-Struktur . Die -Methode wählt die am besten geeignete Formatstruktur (pbFormat) aus.
FORMAT_MFVideoFormat
 Konvertieren Sie den Medientyp in eine DirectShow-AM_MEDIA_TYPE-Struktur mit einer MFVIDEOFORMAT-Formatstruktur .
FORMAT_VideoInfo
 Konvertieren Sie den Medientyp in eine DirectShow-AM_MEDIA_TYPE-Struktur mit einer VIDEOINFOHEADER-Formatstruktur .
FORMAT_VideoInfo2
 Konvertieren Sie den Medientyp in eine DirectShow-AM_MEDIA_TYPE-Struktur mit einer VIDEOINFOHEADER2 Formatstruktur.

[out] ppvRepresentation

Empfängt einen Zeiger auf eine Struktur, die die Darstellung enthält. Die -Methode weist den Arbeitsspeicher für die -Struktur zu. Der Aufrufer muss den Arbeitsspeicher freigeben, indem er IMFMediaType::FreeRepresentation aufruft.

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_ATTRIBUTENOTFOUND
 Die Details des Medientyps stimmen nicht mit der angeforderten Darstellung überein.
MF_E_INVALIDMEDIATYPE
 Der Medientyp ist ungültig.
MF_E_UNSUPPORTED_REPRESENTATION
 Der Medientyp unterstützt die angeforderte Darstellung nicht.

Hinweise

Wenn Sie eine bestimmte Formatstruktur im guidRepresentation-Parameter anfordern, z. B. VIDEOINFOHEADER, gehen möglicherweise einige der Formatinformationen verloren.

Sie können auch die MFInitAMMediaTypeFromMFMediaType-Funktion verwenden, um einen Media Foundation-Medientyp in einen DirectShow-Medientyp zu konvertieren.

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

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 mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaType

MFVIDEOFORMAT

Medientypen