Função DrvSendPage (winddi.h)

Artigo
08/27/2023

Uma função DrvSendPage de gráficos de impressora é chamada pela GDI quando termina de desenhar uma página física, para que o driver possa enviar a página para a impressora.

Sintaxe

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Parâmetros

[in] pso

Ponteiro fornecido pelo chamador para uma estrutura SURFOBJ que descreve a superfície de desenho.

Valor retornado

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

A GDI chama DrvSendPage sempre que termina de desenhar a imagem de uma página física na superfície de desenho. A função é responsável por chamar EngWritePrinter para enviar a imagem para a impressora e para executar operações de fim de página, como ejetar a página.

As DLLs de elementos gráficos de impressora que usam superfícies gerenciadas por GDI normalmente são implementadas para que, para páginas agrupadas, a imagem de cada banda seja enviada para a impressora pela função DrvNextBand do driver.

Além disso, se uma DLL de gráficos de impressora estiver usando uma superfície gerenciada pelo dispositivo, a função DrvSendPage normalmente só precisará executar operações de fim de página, pois a imagem é enviada para a impressora conforme ela é desenhada.

Se houver um potencial para essa função levar muito tempo para ser executada, ela deverá chamar EngCheckAbort a cada cinco segundos. Se EngCheckAbort retornar TRUE, DrvSendPage deverá encerrar sua operação e retornar FALSE.