Función DrvSendPage (winddi.h)

Artículo
08/27/2023

GDI llama a la función DrvSendPage de un archivo DLL de gráficos de impresora cuando ha terminado de dibujar una página física, por lo que el controlador puede enviar la página a la impresora.

Sintaxis

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Parámetros

[in] pso

Puntero proporcionado por el autor de la llamada a una estructura SURFOBJ que describe la superficie de dibujo.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe llamar a la función SetLastError de Win32 para establecer un código de error y, a continuación, devolver FALSE.

Comentarios

GDI llama a DrvSendPage cada vez que ha terminado de dibujar la imagen de una página física en la superficie de dibujo. La función es responsable de llamar a EngWritePrinter para enviar la imagen a la impresora y para realizar operaciones de fin de página, como expulsar la página.

Los archivos DLL de gráficos de impresora que usan superficies administradas por GDI se suelen implementar para que, para las páginas que se agrupan, la función DrvNextBand envía la imagen de cada banda a la impresora.

Además, si un archivo DLL de gráficos de impresora usa una superficie administrada por el dispositivo, la función DrvSendPage normalmente solo necesita realizar operaciones de finalización de página, ya que la imagen se envía a la impresora a medida que se dibuja.

Si existe la posibilidad de que esta función tarde mucho tiempo en ejecutarse, debe llamar a EngCheckAbort cada cinco segundos. Si EngCheckAbort devuelve TRUE, DrvSendPage debe finalizar su operación y devolver FALSE.