Método ID2D1Bitmap::CopyFromBitmap (d2d1.h)

Copia a região especificada do bitmap especificado no bitmap atual.

Sintaxe

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Parâmetros

[in, optional] destPoint

Tipo: const D2D1_POINT_2U*

No bitmap atual, o canto superior esquerdo da área para a qual a região especificada por srcRect é copiada.

[in] bitmap

Tipo: ID2D1Bitmap*

O bitmap a partir do qual copiar.

[in, optional] srcRect

Tipo: const D2D1_RECT_U*

A área de bitmap a ser copiada .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Esse método não atualiza o tamanho do bitmap atual. Se o conteúdo do bitmap de origem não se ajustar ao bitmap atual, esse método falhará. Além disso, observe que esse método não executa a conversão de formato e falhará se os formatos de bitmap não corresponderem.

Chamar esse método pode fazer com que o lote atual seja liberado se o bitmap estiver ativo no lote. Se o lote que foi liberado não for concluído com êxito, esse método falhará. No entanto, esse método não limpa o estado de erro do destino de renderização no qual o lote foi liberado. O HRESULT com falha e o estado da marca serão retornados na próxima chamada para EndDraw ou Flush.

Começando com Windows 8.1, esse método dá suporte a bitmaps compactados em bloco. Se você estiver usando um formato compactado em bloco, as coordenadas finais do parâmetro srcRect deverão ser múltiplas de 4 ou o método retornará E_INVALIDARG.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1.h
Biblioteca	D2d1.lib
DLL	D2d1.dll

Confira também

ID2D1Bitmap