Función DrvStartBanding (winddi.h)

Artículo
03/15/2023

GDI llama a la función DrvStartBanding cuando está listo para empezar a enviar bandas de una página física al controlador para su representación.

Sintaxis

BOOL DrvStartBanding(
  [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 primera 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 DrvStartBanding solo si la función DrvEnableSurface de la DLL de gráficos de impresora anteriormente llamada EngMarkBandingSurface para especificar una superficie de bandas.

El propósito de la función DrvStartBanding es permitir que el archivo DLL de gráficos de impresora realice las inicializaciones necesarias antes de que las operaciones de bandas comiencen en una página física y proporcionen GDI con los índices del origen de la primera banda.

La función DrvStartBanding se llama una vez por página. Cada vez que GDI haya terminado de dibujar una banda, llama a DrvNextBand para que el controlador pueda enviar la banda a la impresora.