Método ID2D1Bitmap::CopyFromMemory (d2d1.h)
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 |