MFInitAMMediaTypeFromMFMediaType-Funktion (mfapi.h)
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 |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
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 |