Méthode IPrintOemUI ::D riverEvent (prcomoem.h)

Article
02/26/2024

La fonction DrvDriverEvent du pilote d’imprimante appelle la méthode d’un IPrintOemUI::DriverEvent plug-in d’interface utilisateur pour le traitement supplémentaire des événements du pilote d’imprimante.

Syntaxe

HRESULT DriverEvent(
  DWORD  dwDriverEvent,
  DWORD  dwLevel,
  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.

Indicateur	Définition
DRIVER_EVENT_DELETE	Le pilote est en cours de suppression.
DRIVER_EVENT_INITIALIZE	Le pilote vient d’être installé.

dwLevel

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

dwLevel Valeur	Structure pointée vers pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

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

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

La méthode doit retourner l’une des valeurs suivantes.

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L'opération a échoué.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

La méthode d’un IPrintOemUI::DriverEvent plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvDriverEvent exportée par les DLL d’interface d’imprimante en mode utilisateur. Pour plus d’informations sur les événements de pilote et leur traitement, consultez la description de la fonction DrvDriverEvent .

Si vous fournissez un plug-in d’interface utilisateur, la fonction DrvDriverEvent du pilote d’imprimante appelle la IPrintOemUI::DriverEvent méthode. La fonction DrvDriverEvent effectue son propre traitement pour l’événement spécifié, puis appelle la méthode pour gérer le IPrintOemUI::DriverEvent traitement supplémentaire de l’événement.

Si IPrintOemUI::DriverEvent les méthodes sont exportées par plusieurs plug-ins d’interface utilisateur, les méthodes sont appelées dans l’ordre dans lequel les plug-ins sont spécifiés pour l’installation.

Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimante Microsoft.