Método IPrintOemUI::D riverEvent (prcomoem.h)
A função DrvDriverEvent do driver de impressora chama o método IPrintOemUI::DriverEvent de um plug-in de interface do 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.
| 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.
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
O método deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
Falha na operação. |
|
O método não é implementado. |
Observações
O método IPrintOemUI::DriverEvent de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DrvDriverEvent exportada por DLLs de interface da 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 método IPrintOemUI::DriverEvent. A função DrvDriverEvent executa seu próprio processamento para o evento especificado e, em seguida, chama o método IPrintOemUI::DriverEvent para lidar com o processamento adicional do evento.
Se IPrintOemUI::DriverEvent 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 os drivers de impressora da Microsoft.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |