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

Confira também

ID2D1Bitmap