Función EngCopyBits (winddi.h)
La función EngCopyBits se traduce entre superficies de trama administradas por el dispositivo y mapas de bits de formato estándar GDI.
Sintaxis
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
Parámetros
psoDest
Puntero a una estructura SURFOBJ que describe la superficie de destino de la operación de copia.
psoSrc
Puntero a una estructura SURFOBJ que describe la superficie de origen de la operación de copia.
pco
Puntero a una estructura CLIPOBJ que restringe el área de la superficie de destino que se verá afectada. Este parámetro puede ser NULL.
pxlo
Puntero a una estructura XLATEOBJ que define la traducción de índices de color entre las superficies de origen y destino.
[in] prclDest
Puntero a una estructura RECTL que define el área en el sistema de coordenadas de la superficie de destino que se modificará. El rectángulo es exclusivo de la derecha inferior, lo que significa que los bordes inferior y derecho de este rectángulo no forman parte de la copia.
[in] pptlSrc
Puntero a una estructura POINTL que define la esquina superior izquierda del rectángulo de origen.
Valor devuelto
El valor devuelto es TRUE si la función se realiza correctamente. Si no se realiza correctamente, registra un error y devuelve FALSE.
Comentarios
Los mapas de bits de formato estándar son formato de píxeles empaquetados de un solo plano. Cada línea de examen se alinea en un límite de 4 bytes. Estos mapas de bits tienen 1, 4, 8, 16, 24 o 32 bits por píxel. Consulte la función EngCreateBitmap para obtener una lista de tipos de formato estándar.
GDI llama a esta función desde sus simulaciones.
No se debe llamar a EngCopyBits con un rectángulo de destino vacío y los dos puntos del rectángulo de destino deben estar bien ordenados; es decir, el primer punto debe representar el vértice superior izquierdo del rectángulo y el segundo debe representar el vértice inferior derecho.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |