MFCreateAMMediaTypeFromMFMediaType-Funktion (mfapi.h)

Erstellt eine DirectShow-AM_MEDIA_TYPE-Struktur aus einem Media Foundation-Medientyp.

Syntax

HRESULT MFCreateAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE **ppAMType
);

Parameter

pMFType

Zeiger auf die IMFMediaType-Schnittstelle des zu konvertierenden Medientyps.

guidFormatBlockType

Formattyp-GUID. Dieser Wert entspricht dem Formattypmember der AM_MEDIA_TYPE-Struktur und gibt den Typ des zuzuordnenden Formatblocks an. Wenn der Wert GUID_NULL ist, versucht die Funktion, den richtigen Formatblock basierend auf dem Haupttyp und Untertyp abzuleiten.

ppAMType

Empfängt einen Zeiger auf eine AM_MEDIA_TYPE-Struktur . Der Aufrufer muss den für die Struktur zugewiesenen Arbeitsspeicher freigeben, indem Er CoTaskMemFree aufruft. Die Funktion weist auch Arbeitsspeicher für den Formatblock zu, den der Aufrufer freigeben muss, indem CoTaskMemFree für den pbFormat-Member aufgerufen wird.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Diese Funktion kann auch mit den folgenden Formatstrukturen verwendet werden, die AM_MEDIA_TYPE entsprechen:

• DMO_MEDIA_TYPE (DirectX-Medienobjekte)
• WM_MEDIA_TYPE (Windows Media Format SDK)

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfapi.h
Bibliothek	Mfplat.lib
DLL	Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen

Medientypkonvertierungen

Medientypen