Método ID2D1Bitmap::CopyFromRenderTarget (d2d1.h)
Copia a região especificada do destino de renderização especificado no bitmap atual.
Sintaxe
HRESULT CopyFromRenderTarget(
[in, optional] const D2D1_POINT_2U *destPoint,
[in] ID2D1RenderTarget *renderTarget,
[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] renderTarget
Tipo: ID2D1RenderTarget*
O destino de renderização que contém a região a ser copiada.
[in, optional] srcRect
Tipo: const D2D1_RECT_U*
A área de renderTarget a ser copiada .
Valor retornado
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.
Todos os clipes e camadas devem ser retirados do destino de renderização antes de chamar esse método. O método retornará D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT se quaisquer clipes ou camadas forem aplicados no momento ao destino de renderização.
Requisitos
| 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 |