Funzione MFCopyImage (mfapi.h)

Articolo
03/13/2024

Copia un piano immagine o immagine da un buffer a un altro.

Sintassi

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

Parametri

[in] pDest

Puntatore all'inizio della prima riga di pixel nel buffer di destinazione.

[in] lDestStride

Stride del buffer di destinazione, in byte.

[in] pSrc

Puntatore all'inizio della prima riga di pixel nell'immagine di origine.

[in] lSrcStride

Stride dell'immagine di origine, in byte.

[in] dwWidthInBytes

Larghezza dell'immagine, in byte.

[in] dwLines

Numero di righe di pixel da copiare.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione copia un singolo piano dell'immagine. Per i formati YUV planari, è necessario chiamare la funzione una volta per ogni piano. In questo caso, pDest e pSrc devono puntare all'inizio di ogni piano.

Questa funzione è ottimizzata se i set di istruzioni MMX, SSE o SSE2 sono disponibili nel processore. La funzione esegue un archivio non temporale (i dati vengono scritti in memoria direttamente senza inquinare la cache).

Nota Prima di Windows 7, questa funzione è stata esportata da evr.dll. A partire da Windows 7, questa funzione viene esportata da mfplat.dll e evr.dll esporta una funzione stub che chiama in mfplat.dll. Per altre informazioni, vedere Modifiche alla libreria in Windows 7.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Evr.lib
DLL	Mfplat.dll

Vedi anche

Immagine Stride

Funzioni di Media Foundation

Tipi di supporti

Share via