Função MFCopyImage (mfapi.h)

  • Artigo

Copia uma imagem ou plano de imagem de um buffer para outro.

Sintaxe

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

Ponteiro para o início da primeira linha de pixels no buffer de destino.

[in] lDestStride

Passo a passo do buffer de destino, em bytes.

[in] pSrc

Ponteiro para o início da primeira linha de pixels na imagem de origem.

[in] lSrcStride

Passo da imagem de origem, em bytes.

[in] dwWidthInBytes

Largura da imagem, em bytes.

[in] dwLines

Número de linhas de pixels a serem copiados.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função copia um único plano da imagem. Para formatos YUV planar, você deve chamar a função uma vez para cada plano. Nesse caso, pDest e pSrc devem apontar para o início de cada plano.

Essa função será otimizada se os conjuntos de instruções MMX, SSE ou SSE2 estiverem disponíveis no processador. A função executa um repositório não temporal (os dados são gravados na memória diretamente sem poluir o cache).

Nota Antes do Windows 7, essa função era exportada de evr.dll. A partir do Windows 7, essa função é exportada de mfplat.dll e evr.dll exporta uma função stub que chama mfplat.dll. Para obter mais informações, consulte Alterações de biblioteca no Windows 7.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Evr.lib
DLL Mfplat.dll

Confira também

Passo da imagem

Funções do Media Foundation

Tipos de mídia