Compartilhar via

Função DrvEndDoc (winddi.h)

  • Artigo

A função DrvEndDoc é chamada pela GDI quando termina de enviar um documento para o driver para renderização.

Sintaxe

BOOL DrvEndDoc(
  [in] SURFOBJ *pso,
  [in] FLONG   fl
);

Parâmetros

[in] pso

Ponteiro fornecido pelo chamador para uma estrutura SURFOBJ .

[in] fl

Conjunto de sinalizadores de bits fornecido pelo chamador. O seguinte sinalizador é definido:

Sinalizador Definição
ED_ABORTDOC O trabalho de impressão está sendo encerrado antes da conclusão.

Retornar valor

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

Comentários

Uma DLL de gráficos de impressora deve fornecer uma função DrvEndDoc . A função é chamada após a última página física de um trabalho de impressão ter sido renderizada.

Normalmente, a função é usada para enviar sequências de controle para o hardware da impressora, depois que um documento é impresso, chamando a função EngWritePrinter da GDI. A função também pode executar operações de limpo-up internas específicas do documento para a DLL de elementos gráficos da impressora.

Como não há uma chamada separada para a DLL de gráficos da impressora quando um trabalho de impressão é concluído, a função DrvEndDoc também deve enviar sequências de controle para a impressora para encerrar o trabalho, se necessário pela impressora. (Em outras palavras, há um documento por trabalho.)

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

DrvStartDoc