Función MFCopyImage (mfapi.h)

  • Artículo

Copia una imagen o plano de imagen de un búfer a otro.

Sintaxis

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

Parámetros

[in] pDest

Puntero al inicio de la primera fila de píxeles en el búfer de destino.

[in] lDestStride

Intervalo del búfer de destino, en bytes.

[in] pSrc

Puntero al inicio de la primera fila de píxeles de la imagen de origen.

[in] lSrcStride

Intervalo de la imagen de origen, en bytes.

[in] dwWidthInBytes

Ancho de la imagen, en bytes.

[in] dwLines

Número de filas de píxeles que se van a copiar.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función copia un único plano de la imagen. Para los formatos YUV planar, debe llamar a la función una vez para cada plano. En este caso, pDest y pSrc deben apuntar al inicio de cada plano.

Esta función está optimizada si los conjuntos de instrucciones MMX, SSE o SSE2 están disponibles en el procesador. La función realiza un almacén no temporal (los datos se escriben en la memoria directamente sin contaminar la memoria caché).

Nota Antes de Windows 7, esta función se exportó desde evr.dll. A partir de Windows 7, esta función se exporta desde mfplat.dll y evr.dll exporta una función de código auxiliar que llama a mfplat.dll. Para obtener más información, consulta Cambios de biblioteca en Windows 7.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfapi.h
Library Evr.lib
Archivo DLL Mfplat.dll

Consulte también

Intervalo de imagen

Funciones de Media Foundation

Tipos de medios