Funzione DrvDriverEvent (winddiui.h)

Articolo
02/07/2025

Lo spooler di stampa chiama la DLL dell'interfaccia della stampante drvDriverEvent funzione 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.

Bandiera	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.

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

Le struttureDRIVER_INFO_ N sono descritte nella documentazione di 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.

Osservazioni

La funzione di drvDriverEvent facoltativa viene chiamata dalla funzione di AddPrinterDriverEx e DeletePrinterDriverEx, descritte nella documentazione di Windows SDK.

Lo scopo della funzione è consentire a un driver della stampante DLL dell'interfaccia 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 DeletePrinterDriverEx della funzione dwDeleteFlag. 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	winddiui.h (include Winddiui.h)

Condividi tramite