Função DrvNextBand (winddi.h)

Artigo
03/13/2024

A função DrvNextBand é chamada pela GDI quando termina de desenhar uma faixa para uma página física, para que o driver possa enviar a próxima faixa para a impressora.

Sintaxe

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

Parâmetros

[in] pso

Ponteiro fornecido pelo chamador para uma estrutura SURFOBJ , que identifica a superfície de faixa.

[in] pptl

Ponteiro fornecido pelo chamador para uma estrutura POINTL para receber a origem fornecida pela função da próxima banda.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE. Caso contrário, ele deve chamar a função SetLastError do Win32 para definir um código de erro e retornar FALSE.

Comentários

Se uma DLL de elementos gráficos de impressora usar superfícies gerenciadas por GDI e se der suporte à faixa de superfície, ela deverá fornecer uma função DrvNextBand . A GDI chama DrvNextBand sempre que termina de desenhar a parte da imagem da página que pode estar contida na superfície da banda. A superfície usada pela GDI para desenho é aquela que o driver especificou anteriormente chamando EngMarkBandingSurface. A função deve enviar a imagem para a impressora chamando EngWritePrinter e deve retornar os índices da origem da próxima banda na estrutura POINTL apontada por pptl.

Depois que todas as faixas de uma página física tiverem sido desenhadas, a função deverá definir ambos os membros da estrutura POINTL apontados por pptl como -1.