structure WIA_DEV_CAP_DRV (wiamindr_lh.h)
La structure WIA_DEV_CAP_DRV est utilisée pour énumérer les fonctionnalités d’appareil. Une fonctionnalité d’appareil est définie par un événement ou une commande pris en charge par l’appareil.
Syntaxe
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
Membres
guid
Pointe vers un GUID qui identifie la fonctionnalité de l’appareil. Ce membre peut être défini sur l’une des valeurs spécifiées pour les commandes d’appareil WIA (WIA_CMD_commandes XXX) ou les identificateurs d’événements WIA (WIA_EVENT_XXX identificateurs d’événement). Pour plus d’informations, consultez commandes d’appareil WIA.
Le pilote peut définir son propre GUID de capacité qu’il peut envoyer à l’appareil. Toutefois, une application doit avoir des connaissances spécifiques sur cette fonctionnalité pour pouvoir répondre à la nouvelle fonctionnalité. Une application reconnaît normalement uniquement les GUID d’événements et de commande WIA standard (WIA_CMD_XXX et WIA_EVENT_XXX).
ulFlags
Spécifie le type d’événement. Ce membre peut être défini sur un ou les deux éléments suivants :
| Drapeau | Signification |
|---|---|
| WIA_ACTION_EVENT | L’application peut inscrire une action pour l’événement donné à l’aide des méthodes IWiaDevMgr ::RegisterEventCallbackProgram et IwiaDevMgr ::RegisterEventCallbackCLSID. Un événement d’action lance l’application inscrite pour gérer un tel événement. |
| WIA_NOTIFICATION_EVENT | L’application peut s’inscrire à la notification sur l’événement donné à l’aide de la méthode IwiaDevMgr ::RegisterEventCallbackInterface. Un événement de notification est envoyé uniquement aux applications qui sont déjà en cours d’exécution. |
wszName
Spécifie une chaîne qui contient une version courte du nom de la fonctionnalité.
wszDescription
Spécifie une chaîne contenant la version du nom de fonctionnalité qui peut être affichée à l’utilisateur.
wszIcon
Spécifie une chaîne contenant le nom de l’icône pour cette fonctionnalité. L’icône peut être affichée à l’utilisateur.
Remarques
Le service WIA appelle la fonction IWiaMiniDrv ::d rvGetCapabilities du minidriver pour renseigner les membres d’une structure WIA_DEV_CAP_DRV.
Lorsqu’un pilote énumére des gestionnaires d’événements, la seule valeur valide est WIA_IS_DEFAULT_HANDLER ; qui indique que le gestionnaire actuellement inscrit doit être utilisé.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |