Compartilhar via


Função DrvDriverEvent (winddiui.h)

O spooler de impressão chama a função DrvDriverEvent de uma interface de impressora quando o spooler processa eventos específicos do driver que podem exigir ação do driver da 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.

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

dwLevel

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

dwLevel Valor Estrutura apontada por pDriverInfo
1 DRIVER_INFO_1
2 DRIVER_INFO_2
3 DRIVER_INFO_3

As estruturas 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.

Retornar valor

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

Comentários

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

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

Se dwDriverEvent for DRIVER_EVENT_DELETE, o parâmetro lparam conterá os sinalizadores especificados para o parâmetro dwDeleteFlag da função DeletePrinterDriverEx. O parâmetro lparam não será usado se dwDriverEvent for 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
Plataforma de Destino Área de Trabalho
Cabeçalho winddiui.h (inclua Winddiui.h)