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

Copia la región especificada de la memoria en el mapa de bits actual.

Sintaxis

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*

En el mapa de bits actual, el rectángulo al que se copia la región especificada por srcRect .

[in] srcData

Tipo: const void*

Los datos que se copiarán.

pitch

Tipo: UINT32

El paso, o el tono, del mapa de bits de origen almacenado en srcData. El intervalo es el recuento de bytes de una línea de digitalización (una fila de píxeles en memoria). El intervalo se puede calcular con la fórmula siguiente: ancho de píxel * bytes por píxel + relleno de memoria.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Este método no actualiza el tamaño del mapa de bits actual. Si el contenido del mapa de bits de origen no cabe en el mapa de bits actual, se produce un error en este método. Además, tenga en cuenta que este método no realiza la conversión de formato; los dos formatos de mapa de bits deben coincidir.

Si este método se pasa una entrada no válida (por ejemplo, un rectángulo de destino no válido), puede producir resultados impredecibles, como una imagen distorsionada o un error del dispositivo.

Llamar a este método puede hacer que el lote actual se vacíe si el mapa de bits está activo en el lote. Si el lote que se ha vaciado no se completa correctamente, se produce un error en este método. Sin embargo, este método no borra el estado de error del destino de representación en el que se ha vaciado el lote. El estado hrESULT y etiqueta con errores se devolverá en la siguiente llamada a EndDraw o Flush.

A partir de Windows 8.1, este método admite mapas de bits comprimidos en bloques. Si usa un formato comprimido de bloque, las coordenadas finales del parámetro srcRect deben ser múltiplo de 4 o el método devuelve E_INVALIDARG.

Requisitos

Consulte también

ID2D1Bitmap