Funzione DrvDriverEvent (winddiui.h)

  • Articolo

Lo spooler di stampa chiama la funzione DrvDriverEvent di una DLL dell'interfaccia della stampante quando lo spooler elabora eventi specifici del driver che potrebbero richiedere un'azione da parte del driver della stampante.

Sintassi

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

Parametri

dwDriverEvent

Flag di bit fornito dal chiamante che indica l'evento che si è verificato. I flag validi sono elencati nella tabella seguente.

Flag Definizione
DRIVER_EVENT_DELETE Il driver viene rimosso.
DRIVER_EVENT_INITIALIZE Il driver è stato appena installato.

dwLevel

Valore fornito dal chiamante che indica il tipo di struttura a cui punta il parametro pDriverInfo , come indicato nella tabella seguente.

dwLevel Valore Struttura a cui punta pDriverInfo
1 DRIVER_INFO_1
2 DRIVER_INFO_2
3 DRIVER_INFO_3

Le strutture DRIVER_INFO_N sono descritte nella documentazione Microsoft Windows SDK.

[in, optional] pDriverInfo

Puntatore fornito dal chiamante a una struttura il cui tipo è identificato dal parametro dwLevel .

lParam

Flag forniti dal chiamante. Vedere la sezione Osservazioni seguente.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve restituire FALSE.

Commenti

La funzione DrvDriverEvent facoltativa viene chiamata dalle funzioni AddPrinterDriverEx e DeletePrinterDriverEx dello spooler, descritte nella documentazione di Windows SDK.

Lo scopo della funzione è consentire alla DLL dell'interfaccia della stampante di un driver della stampante di eseguire le operazioni necessarie quando il driver viene installato o rimosso. Un'operazione tipica per questa funzione da eseguire consiste nel creare o rimuovere file aggiuntivi specifici del driver non specificati come file dipendenti in un file INF della stampante.

Se dwDriverEvent è DRIVER_EVENT_DELETE, il parametro lparam contiene i flag specificati per il parametro dwDeleteFlag della funzione DeletePrinterDriverEx. Il parametro lparam non viene usato se dwDriverEvent è DRIVER_EVENT_INITIALIZE.

Poiché la funzione DrvDriverEvent viene chiamata nel contesto dello spooler di stampa, non può visualizzare un'interfaccia utente.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winddiui.h (include Winddiui.h)