DrvDriverEvent, fonction (winddiui.h)

Le spouleur d’impression appelle la fonction DrvDriverEvent de la DLL d’une interface d’imprimante lorsque le spouleur traite des événements spécifiques au pilote qui peuvent nécessiter une action du 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.

dwLevel

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

Les structures DRIVER_INFO_N sont décrites dans la documentation Microsoft Windows SDK.

[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 retournée

Si l’opération réussit, la fonction doit retourner TRUE. Dans le cas contraire, elle doit retourner FALSE.

Remarques

La fonction DrvDriverEvent facultative est appelée par les fonctions AddPrinterDriverEx et DeletePrinterDriverEx du spouleur, qui sont décrites dans la documentation SDK Windows.

L’objectif de la fonction est de permettre à la DLL d’interface d’imprimante d’un pilote d’imprimante d’effectuer les opérations nécessaires lors de l’installation ou de la suppression du pilote. 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 dwDeleteFlag de la fonction DeletePrinterDriverEx. 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.

Configuration requise