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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | d2d1.h |
| Library | D2d1.lib |
| Archivo DLL | D2d1.dll |