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

Consulte también

CLIPOBJ

SURFOBJ

XLATEOBJ