Função DrvEndDoc (winddi.h)
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) |