structure WIA_DEV_CAP_DRV (wiamindr_lh.h)

Article
08/08/2023

La structure WIA_DEV_CAP_DRV est utilisée pour énumérer les fonctionnalités de l’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_ commandesXXX ) ou les identificateurs d’événements WIA (WIA_EVENT_ Identificateurs d’événementsXXX ). Pour plus d’informations, consultez Commandes d’appareil WIA.

Le pilote peut définir son propre GUID de fonctionnalité qu’il peut envoyer à l’appareil. Toutefois, une application doit avoir des connaissances spécifiques sur cette capacité pour pouvoir répondre à la nouvelle fonctionnalité. Une application reconnaît normalement uniquement les GUID d’événement 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 l’un ou les deux des éléments suivants :

Indicateur	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 pour recevoir une 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 la 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 pour l’utilisateur .

Remarques

Le service WIA appelle la fonction IWiaMiniDrv ::d rvGetCapabilities du minidriver pour renseigner les membres d’une structure de WIA_DEV_CAP_DRV.

Lorsqu’un pilote énumére des gestionnaires d’événements, la seule valeur valide est WIA_IS_DEFAULT_HANDLER ; ce qui indique que le gestionnaire actuellement inscrit doit être utilisé.

Configuration requise

Condition requise	Valeur
En-tête	wiamindr_lh.h (inclure Wiamindr.h)

Voir aussi

Fonctionnalités du pilote

IWiaMiniDrv ::d rvGetCapabilities

Partager via