Fonction MFCreateAMMediaTypeFromMFMediaType (mfapi.h)

Crée une structure de AM_MEDIA_TYPE DirectShow à partir d’un type de média Media Foundation.

Syntaxe

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

Paramètres

pMFType

Pointeur vers l’interface IMFMediaType du type de média à convertir.

guidFormatBlockType

Formater le GUID de type. Cette valeur correspond au membre formattype de la structure AM_MEDIA_TYPE et spécifie le type de bloc de format à allouer. Si la valeur est GUID_NULL, la fonction tente de déduire le bloc de format correct, en fonction du type principal et du sous-type.

ppAMType

Reçoit un pointeur vers une structure AM_MEDIA_TYPE . L’appelant doit libérer la mémoire allouée pour la structure en appelant CoTaskMemFree. La fonction alloue également de la mémoire pour le bloc de format, que l’appelant doit libérer en appelant CoTaskMemFree sur le membre pbFormat .

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	La fonction a réussi.

Notes

Cette fonction peut également être utilisée avec les structures de format suivantes qui sont équivalentes à AM_MEDIA_TYPE :

• DMO_MEDIA_TYPE (objets multimédias DirectX)
• WM_MEDIA_TYPE (Kit de développement logiciel (SDK) au format Windows Media

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfapi.h
Bibliothèque	Mfplat.lib
DLL	Mfplat.dll

Voir aussi

Fonctions Media Foundation

Conversions de types de média

Types de médias