Fonction MFCopyImage (mfapi.h)

Article
03/01/2024

Copie une image ou un plan d’image d’une mémoire tampon vers une autre.

Syntaxe

HRESULT MFCopyImage(
  [in] BYTE       *pDest,
  [in] LONG       lDestStride,
  [in] const BYTE *pSrc,
  [in] LONG       lSrcStride,
  [in] DWORD      dwWidthInBytes,
  [in] DWORD      dwLines
);

Paramètres

[in] pDest

Pointeur vers le début de la première ligne de pixels dans la mémoire tampon de destination.

[in] lDestStride

Stride de la mémoire tampon de destination, en octets.

[in] pSrc

Pointeur vers le début de la première ligne de pixels dans l’image source.

[in] lSrcStride

Stride de l’image source, en octets.

[in] dwWidthInBytes

Largeur de l’image, en octets.

[in] dwLines

Nombre de lignes de pixels à copier.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction copie un seul plan de l’image. Pour les formats YUV planaires, vous devez appeler la fonction une fois pour chaque plan. Dans ce cas, pDest et pSrc doivent pointer vers le début de chaque plan.

Cette fonction est optimisée si les jeux d’instructions MMX, SSE ou SSE2 sont disponibles sur le processeur. La fonction effectue un magasin non temporel (les données sont écrites directement en mémoire sans polluer le cache).

Note Avant Windows 7, cette fonction était exportée à partir de evr.dll. À partir de Windows 7, cette fonction est exportée à partir de mfplat.dll et evr.dll exporte une fonction stub qui appelle mfplat.dll. Pour plus d’informations, consultez Modifications de bibliothèque dans Windows 7.

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	Evr.lib
DLL	Mfplat.dll

Voir aussi

Stride d’image

Fonctions Media Foundation

Types de média

Partager via