MÉTHODE IMFSample ::GetBufferByIndex (mfobjects.h)

Article
02/28/2024

Obtient une mémoire tampon de l’exemple, par index.

Note Dans la plupart des cas, il est plus sûr d’utiliser la méthode IMFSample ::ConvertToContiguousBuffer . Si l’exemple contient plusieurs mémoires tampons, la méthode ConvertToContiguousBuffer les remplace par une seule mémoire tampon, copie les données d’origine dans cette mémoire tampon et retourne la nouvelle mémoire tampon à l’appelant. L’opération de copie se produit au plus une fois. Lors des appels suivants, aucune donnée n’est copiée.

Syntaxe

HRESULT GetBufferByIndex(
  [in]  DWORD          dwIndex,
  [out] IMFMediaBuffer **ppBuffer
);

Paramètres

[in] dwIndex

Index de la mémoire tampon. Pour trouver le nombre de mémoires tampons dans l’exemple, appelez IMFSample ::GetBufferCount. Les mémoires tampons sont indexées à partir de zéro.

[out] ppBuffer

Reçoit un pointeur vers l’interface IMFMediaBuffer . L’appelant doit libérer l’interface.

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
E_INVALIDARG	Argument pointeur NULL, ou l’index est hors plage.

Remarques

Un exemple peut contenir plusieurs mémoires tampons. Utilisez la méthode GetBufferByIndex pour énumérer les mémoires tampons individuelles.

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

IMFSample

IMFSample ::ConvertToContiguousBuffer

Exemples multimédias

Partager via