Funzione DrvDriverEvent (winddiui.h)

Lo spooler di stampa chiama la funzione DrvDriverEvent della DLL dell'interfaccia della stampante quando lo spooler elabora eventi specifici del driver che potrebbero richiedere l'intervento 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.

Contrassegno Definizione
DRIVER_EVENT_DELETE È in corso la rimozione del driver.
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 DRIVER_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.

Commenti

La funzione facoltativa DrvDriverEvent 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 da eseguire per questa funzione è la creazione o la rimozione di 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

   
Piattaforma di destinazione Desktop
Intestazione winddiui.h (includere Winddiui.h)