Funções definidas pelas DLLs gráficas da impressora
Importante
A moderna plataforma de impressão é o meio preferido do Windows para comunicar com as impressoras. Recomendamos que utilize o controlador de classe da caixa de entrada IPP da Microsoft, juntamente com as Aplicações de Suporte de Impressão (PSA), para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.
Para obter mais informações, consulte o guia de design do aplicativo de suporte Print.
Como todos os drivers gráficos, as DLLs gráficas da impressora são responsáveis por definir as seguintes funções DDI gráficas. Seguindo DrvEnableDriver, o ponto de entrada inicial do driver, as funções restantes são listadas em ordem alfabética. Observe que, como o GDI chama DrvEnableDriver pelo nome, seu nome aparece em negrito. GDI chama todas as outras funções de driver de vídeo por meio de uma matriz de ponteiros de função que DrvEnableDriver retorna.
| Nome da função | Descrição |
|---|---|
| DrvEnableDriver | Permite que o driver inicialize-se e retorne ponteiros para funções DDI gráficas suportadas. |
| DrvCompletePDEV | Fornece ao driver um identificador GDI para uma instância de dispositivo. |
| DrvDisableDriver | (Opcional) Permite que o motorista execute operações de limpeza antes de ser descarregado. |
| DrvDisablePDEV | Permite que o driver remova informações específicas da instância do dispositivo. |
| DrvDisableSurface | Permite ao condutor remover uma superfície de desenho. |
| DrvEnablePDEV | Permite que o driver forneça ao GDI características físicas do dispositivo e inicialize informações específicas da instância do dispositivo. |
| DrvEnableSurface | Permite ao condutor criar uma superfície de desenho. |
| DrvQueryDeviceSupport | (Opcional) Retorna informações específicas do dispositivo solicitadas. |
| DrvQueryDriverInfo | (Opcional) Retorna as informações específicas do driver solicitadas. |
As DLLs gráficas da impressora também são responsáveis por definir as seguintes funções DDI gráficas específicas de impressão, que são chamadas em determinados pontos durante a renderização de um trabalho de impressão.
| Função | Quando chamado |
|---|---|
| DrvEndDoc | Quando o GDI tiver terminado de enviar um documento para o driver para renderização. |
| DrvNextBand | (Opcional) Quando o GDI terminar de desenhar uma banda para uma página física, para que o driver possa enviar a banda para a impressora. |
| DrvQueryPerBandInfo | (Opcional) Antes do GDI começar a desenhar uma banda para uma página física, para que o driver possa fornecer ao GDI informações específicas da banda. |
| DrvSendPage | Quando o GDI terminar de desenhar uma página física, para que o driver possa enviar a página para a impressora. |
| DrvStartBanding | (Opcional) Quando o GDI estiver pronto para começar a enviar bandas de uma página física para o driver para renderização. |
| DrvStartDoc | Quando o GDI estiver pronto para começar a enviar um documento para o driver para renderização. |
| DrvStartPage | Quando o GDI estiver pronto para começar a enviar uma página de documento para o driver para renderização. |
Normalmente, uma DLL gráfica de impressora também define quaisquer funções DDI gráficas adicionais necessárias para realizar a renderização do trabalho de impressão. O número e o tipo de funções definidas dependem:
Se o driver suporta o uso de superfícies de desenho gerenciadas por GDI ou por dispositivo (ou ambas). Para obter mais informações, consulte Tipos de superfície.
Até que ponto as operações de desenho podem ser tratadas pelo GDI em vez de serem realizadas pelo próprio condutor. Para obter mais informações, consulte Usando oDDI de gráficos .
Todas as funções definidas pelas DLLs gráficas da impressora são chamadas pelo mecanismo de renderização de gráficos de modo kernel (GRE) da GDI.
O DrvEnableDriver e as funções DrvQueryDriverInfo são exportadas pela DLL gráfica. Os endereços de todas as outras funções DDI gráficas suportadas são colocados numa tabela que é retornada pela função DrvEnableDriver.