MFInitAMMediaTypeFromMFMediaType-Funktion (mfapi.h)

  • Artikel

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

Syntax

HRESULT MFInitAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE *pAMType
);

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.

pAMType

Zeiger auf eine AM_MEDIA_TYPE-Struktur . Die Funktion ordnet arbeitsspeicher für den Formatblock zu. Der Aufrufer muss den Formatblock freigeben, indem er CoTaskMemFree für den pbFormat-Member aufruft.

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.
MF_E_INVALIDMEDIATYPE
 Der Medientyp ist ungültig.

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