Compartilhar via


Método IPrintOemUI::D riverEvent (prcomoem.h)

A função DrvDriverEvent do driver de impressora chama o método de um plug-in de interface do IPrintOemUI::DriverEvent usuário para processamento adicional de eventos de driver de impressora.

Sintaxe

HRESULT DriverEvent(
  DWORD  dwDriverEvent,
  DWORD  dwLevel,
  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 apontado 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.

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

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
A operação foi realizada com êxito.
E_FAIL
Falha na operação.
E_NOTIMPL
O método não está implementado.

Comentários

O método de um plug-in de interface do IPrintOemUI::DriverEvent usuário executa os mesmos tipos de operações que a função DrvDriverEvent exportada por DLLs de interface de impressora no modo de usuário. Para obter informações sobre eventos de driver e como eles devem ser processados, consulte a descrição da função DrvDriverEvent .

Se você fornecer um plug-in de interface do usuário, a função DrvDriverEvent do driver de impressora chamará o IPrintOemUI::DriverEvent método . A função DrvDriverEvent executa seu próprio processamento para o evento especificado e, em seguida, chama o IPrintOemUI::DriverEvent método para manipular o processamento adicional do evento.

Se IPrintOemUI::DriverEvent os métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando drivers de impressora da Microsoft.

Requisitos

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

Confira também

DrvDriverEvent

IPrintOemUI