IMFVideoMediaType ::GetVideoRepresentation, méthode (mfobjects.h)

[Cette API n’est pas prise en charge et peut être modifiée ou indisponible à l’avenir. Au lieu de cela, les applications doivent définir l’attribut MF_MT_DEFAULT_STRIDE sur le type de média pour spécifier la foulée de surface, puis appeler IMFMediaType ::GetRepresentation.]

Récupère une autre représentation du type de média.

Syntaxe

HRESULT GetVideoRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation,
  [in]  LONG   lStride
);

Paramètres

[in] guidRepresentation

GUID qui spécifie la représentation à récupérer. Pour obtenir la liste des valeurs, consultez IMFMediaType ::GetRepresentation.

[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.

[in] lStride

Stride de la surface vidéo, en octets. Si la foulée est inconnue, définissez cette valeur sur 0. Si la valeur est 0, la méthode calcule la foulée à partir de la largeur de l’image et suppose qu’il n’y a pas de remplissage.

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

Remarques

Cette méthode est équivalente à IMFMediaType ::GetRepresentation , mais inclut le paramètre lStride .

Au lieu d’appeler cette méthode, les applications doivent définir l’attribut MF_MT_DEFAULT_STRIDE sur le type de média pour spécifier la foulée de surface, puis appeler IMFMediaType ::GetRepresentation.

Configuration requise

Condition requise	Valeur
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	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

IMFVideoMediaType

Types de média