Función DrvNextBand (winddi.h)

Artículo
08/27/2023

GDI llama a la función DrvNextBand cuando ha terminado de dibujar una banda para una página física, por lo que el controlador puede enviar la siguiente banda a la impresora.

Sintaxis

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

Parámetros

[in] pso

Puntero proporcionado por el autor de la llamada a una estructura SURFOBJ , que identifica la superficie de bandas.

[in] pptl

Puntero proporcionado por el autor de la llamada a una estructura POINTL para recibir el origen proporcionado por la función de la siguiente banda.

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

Si un archivo DLL de gráficos de impresora usa superficies administradas por GDI y, si admite bandas de superficie, debe proporcionar una función DrvNextBand . GDI llama a DrvNextBand cada vez que ha terminado de dibujar la parte de la imagen de la página que se puede contener en la superficie de la banda. La superficie utilizada por GDI para dibujar es una que el controlador especificado anteriormente llamando a EngMarkBandingSurface. La función debe enviar la imagen a la impresora llamando a EngWritePrinter y debe devolver los índices del origen de la banda siguiente en la estructura POINTL a la que apunta pptl.

Una vez dibujadas todas las bandas de una página física, la función debe establecer ambos miembros de la estructura POINTL a la que apunta pptl a -1.