Partager via


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

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