Fonction MFInitAMMediaTypeFromMFMediaType (mfapi.h)

  • Article

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

Syntaxe

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

Paramètres

pMFType

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

guidFormatBlockType

GUID du type de format. 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.

pAMType

Pointeur vers une structure AM_MEDIA_TYPE . La fonction alloue de la mémoire pour le bloc de format. L’appelant doit libérer le bloc de format 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.
MF_E_INVALIDMEDIATYPE
 Le type de média n’est pas valide.

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