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

  • Artigo

Copia a região especificada da memória para o bitmap atual.

Sintaxe

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

Parâmetros

[in, optional] dstRect

Tipo: const D2D1_RECT_U*

No bitmap atual, o retângulo para o qual a região especificada por srcRect é copiada.

[in] srcData

Tipo: const void*

Os dados a serem copiados.

pitch

Tipo: UINT32

O passo, ou pitch, do bitmap de origem armazenado em srcData. A distância é a contagem de bytes de uma linha de verificação (uma linha de pixels na memória). A distância pode ser calculado a partir da seguinte fórmula: largura do pixel * bytes por pixel + preenchimento de memória.

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; os dois formatos de bitmap devem corresponder.

Se esse método for passado uma entrada inválida (como um retângulo de destino inválido), poderá produzir resultados imprevisíveis, como uma imagem distorcida ou uma falha de dispositivo.

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 Platform Update 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