Función DrvCopyBits (winddi.h)

La función DrvCopyBits se traduce entre superficies de trama administradas por el dispositivo y mapas de bits de formato estándar GDI.

Sintaxis

BOOL DrvCopyBits(
  SURFOBJ  *psoDest,
  SURFOBJ  *psoSrc,
  CLIPOBJ  *pco,
  XLATEOBJ *pxlo,
  RECTL    *prclDest,
  POINTL   *pptlSrc
);

Parámetros

psoDest

Puntero a la estructura SURFOBJ de destino para la operación de copia.

psoSrc

Puntero a la estructura SURFOBJ de origen para la operación de copia.

pco

Puntero a una estructura CLIPOBJ que define una región de clip en la superficie de destino.

pxlo

Puntero a una estructura XLATEOBJ que define la traducción de índices de color entre las superficies de origen y de destino. Si pxlo es NULL, no se necesita ninguna traducción.

prclDest

Puntero a una estructura RECTL que define el área que se va a modificar. Esta estructura usa el sistema de coordenadas de la superficie de destino. Los bordes inferior y derecho de este rectángulo no forman parte de la transferencia de bloques de bits, lo que significa que el rectángulo es exclusivo inferior derecho.

Nunca se llama a DrvCopyBits con un rectángulo de destino vacío. Los dos puntos que definen el rectángulo siempre están bien ordenados.

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 superficie de origen se copia correctamente en la superficie de destino.

Comentarios

Opcionalmente, el controlador puede enlazar DrvCopyBits. Si es así, GDI llamará a DrvCopyBits cuando necesite copiar de una superficie a otra y al menos una de las superficies está administrada por el dispositivo.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winddi.h (incluya Winddi.h)

Consulte también

CLIPOBJ

XLATEOBJ