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 |
|---|---|
|
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 |