Méthode IPrintOemUI ::D riverEvent (prcomoem.h)
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 |
|---|---|
|
L’opération a réussi. |
|
L'opération a échoué. |
|
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | prcomoem.h (inclure Prcomoem.h) |