MÉTHODE IMFMediaType ::GetRepresentation (mfobjects.h)

Article
02/28/2024

Récupère une autre représentation du type de média. Actuellement, seule la structure directShow AM_MEDIA_TYPE est prise en charge.

Syntaxe

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

Paramètres

[in] guidRepresentation

GUID qui spécifie la représentation à récupérer. Les valeurs suivantes sont définies.

Valeur	Signification
AM_MEDIA_TYPE_REPRESENTATION	Convertissez le type de média en structure AM_MEDIA_TYPE DirectShow. La méthode sélectionne la structure de format la plus appropriée (pbFormat).
FORMAT_MFVideoFormat	Convertissez le type de média en structure de AM_MEDIA_TYPE DirectShow avec une structure de format MFVIDEOFORMAT .
FORMAT_VideoInfo	Convertissez le type de média en une structure de AM_MEDIA_TYPE DirectShow avec une structure de format VIDEOINFOHEADER .
FORMAT_VideoInfo2	Convertissez le type de média en structure directShow AM_MEDIA_TYPE avec une structure de format VIDEOINFOHEADER2 .

[out] ppvRepresentation

Reçoit un pointeur vers une structure qui contient la représentation. La méthode alloue la mémoire pour la structure. L’appelant doit libérer la mémoire en appelant IMFMediaType ::FreeRepresentation.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_ATTRIBUTENOTFOUND	Les détails du type de média ne correspondent pas à la représentation demandée.
MF_E_INVALIDMEDIATYPE	Le type de média n’est pas valide.
MF_E_UNSUPPORTED_REPRESENTATION	Le type de média ne prend pas en charge la représentation demandée.

Remarques

Si vous demandez une structure de format spécifique dans le paramètre guidRepresentation , tel que VIDEOINFOHEADER, vous risquez de perdre certaines informations de format.

Vous pouvez également utiliser la fonction MFInitAMMediaTypeFromMFMediaType pour convertir un type de média Media Foundation en un type de média DirectShow.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

IMFMediaType

MFVIDEOFORMAT

Types de média

Partager via