Fonction MFCreateMediaBufferWrapper (mfapi.h)

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.

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

Voir aussi

Mémoires tampons multimédias

Fonctions Media Foundation