Função DrvDriverEvent (winddiui.h)

Artigo
02/07/2025

O spooler de impressão chama a função drvDriverEvent da interface de impressora quando o spooler processa eventos específicos do driver que podem exigir ação do driver de impressora.

Sintaxe

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

Parâmetros

dwDriverEvent

Sinalizador de bit fornecido pelo chamador indicando o evento que ocorreu. Os sinalizadores válidos são listados na tabela a seguir.

Bandeira	Definição
DRIVER_EVENT_DELETE	O motorista está sendo removido.
DRIVER_EVENT_INITIALIZE	O driver acabou de ser instalado.

dwLevel

Valor fornecido pelo chamador que indica o tipo de estrutura apontado pelo parâmetro pDriverInfo, conforme indicado na tabela a seguir.

valor de dwLevel	Estrutura apontada por pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

As estruturas de DRIVER_INFO_N são descritas na documentação do SDK do Microsoft Windows.

[in, optional] pDriverInfo

Ponteiro fornecido pelo chamador para uma estrutura cujo tipo é identificado pelo parâmetro dwLevel.

lParam

Sinalizadores fornecidos pelo chamador. Consulte a seção Comentários a seguir.

Valor de retorno

Se a operação for bem-sucedida, a função deverá retornar VERDADEIRO. Caso contrário, ele deverá retornar FALSE .

Observações

A função DrvDriverEvent opcional é chamada pelas funções AddPrinterDriverEx e DeletePrinterDriverEx do spooler, descritas na documentação do SDK do Windows.

A finalidade da função é permitir que a DLL da interface da impressora do driver de impressora executar as operações necessárias quando o driver for instalado ou removido. Uma operação típica para a execução dessa função é criar ou remover arquivos adicionais específicos do driver que não são especificados como arquivos dependentes em um arquivo INF da impressora .

Se dwDriverEvent for DRIVER_EVENT_DELETE, o parâmetro lparam conterá os sinalizadores especificados para o parâmetro DeletePrinterDriverEx da função dwDeleteFlag. O parâmetro lparam não será usado se dwDriverEvent estiver DRIVER_EVENT_INITIALIZE.

Como a função DrvDriverEvent é chamada no contexto do spooler de impressão, ela não pode exibir uma interface do usuário.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	winddiui.h (inclua Winddiui.h)

Compartilhar via