Share via

Fonction MFCreateMediaBufferWrapper (mfapi.h)

  • Article

Crée une mémoire tampon multimédia qui encapsule une mémoire tampon multimédia existante. La nouvelle mémoire tampon multimédia pointe vers la même mémoire que la mémoire tampon multimédia d’origine ou vers un décalage à partir du début de la mémoire.

Syntaxe

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

Paramètres

[in] pBuffer

Pointeur vers l’interface IMFMediaBuffer du tampon multimédia d’origine.

[in] cbOffset

Début de la nouvelle mémoire tampon, en tant que décalage en octets par rapport au début de la mémoire tampon d’origine.

[in] dwLength

Taille de la nouvelle mémoire tampon. La valeur de cbOffset + dwLength doit être inférieure ou égale à la taille des données valides de la mémoire tampon d’origine. (La taille des données valides est retournée par la méthode IMFMediaBuffer ::GetCurrentLength .)

[out] ppBuffer

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

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.
E_INVALIDARG
 Le décalage demandé ou la longueur demandée n’est pas valide.

Remarques

La taille maximale de la mémoire tampon du wrapper est limitée à la taille des données valides dans la mémoire tampon d’origine. Cela peut être inférieur à la taille allouée de la mémoire tampon d’origine. Pour définir la taille des données valides, appelez IMFMediaBuffer ::SetCurrentLength.

Cette fonction 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 Édition Media Center) 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 mfapi.h
Bibliothèque Mfplat.lib
DLL Mfplat.dll

Voir aussi

Mémoires tampons multimédias

Fonctions Media Foundation