DrvDriverEvent, fonction (winddiui.h)

Article
02/07/2025

Le spouleur d’impression appelle la fonction DrvDriverEvent d’une DLL d’interface d’imprimante lorsque le spouleur traite des événements spécifiques au pilote qui peuvent nécessiter une action par le pilote d’imprimante.

Syntaxe

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

Paramètres

dwDriverEvent

Indicateur de bits fourni par l’appelant indiquant l’événement qui s’est produit. Les indicateurs valides sont répertoriés dans le tableau suivant.

Drapeau	Définition
DRIVER_EVENT_DELETE	Le pilote est supprimé.
DRIVER_EVENT_INITIALIZE	Le pilote vient d’être installé.

dwLevel

Valeur fournie par l’appelant indiquant le type de structure pointé par le paramètre pDriverInfo, comme indiqué dans le tableau suivant.

valeur de dwLevel	Structure pointée par pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

Les structures DRIVER_INFO_N sont décrites dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

[in, optional] pDriverInfo

Pointeur fourni par l’appelant vers une structure dont le type est identifié par le paramètre dwLevel.

lParam

Indicateurs fournis par l’appelant. Consultez la section Remarques suivante.

Valeur de retour

Si l’opération réussit, la fonction doit retourner TRUE. Sinon, elle doit retourner FALSE.

Remarques

La fonction facultative DrvDriverEvent est appelée par les fonctions AddPrinterDriverEx et DeletePrinterDriverEx, qui sont décrites dans la documentation du Kit de développement logiciel (SDK) Windows.

L’objectif de la fonction est de permettre à une DLL d’interface d’imprimante du pilote d’imprimante d’effectuer des opérations nécessaires lorsque le pilote est installé ou supprimé. Une opération classique pour cette fonction consiste à créer ou supprimer des fichiers spécifiques au pilote supplémentaires qui ne sont pas spécifiés en tant que fichiers dépendants dans un fichier INF d’imprimante .

Si dwDriverEvent est DRIVER_EVENT_DELETE, le paramètre lparam contient les indicateurs spécifiés pour le paramètre DeletePrinterDriverEx de la fonction dwDeleteFlag. Le paramètre lparam n’est pas utilisé si dwDriverEvent est DRIVER_EVENT_INITIALIZE.

Étant donné que la fonction DrvDriverEvent est appelée dans le contexte du spouleur d’impression, elle ne peut pas afficher une interface utilisateur.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	winddiui.h (include Winddiui.h)

Partager via