Partager via

Ajouter des propriétés WIA à un élément WIA

  • Article

Chaque élément WIA contient des propriétés WIA. Une application lit et écrit les propriétés d’élément WIA pour configurer le minidriver WIA. Le service WIA appelle la méthode IWiaMiniDrv::d rvInitItemProperties une fois pour chaque élément auquel l’application accède, pour initialiser les propriétés de cet élément de minidriver WIA. Si une application ne lit ni n’écrit de propriétés WIA sur un élément, cette méthode n’est pas appelée pour cet élément. Le contexte d’élément vers lequel pointe le paramètre pWiasContext indique l’élément qui sera initialisé avec les propriétés WIA.

La méthode IWiaMiniDrv::d rvInitItemProperties doit effectuer les tâches suivantes :

  1. Utilisez les données reçues dans le paramètre pWiasContext pour déterminer le type d’élément. Le minidriver WIA peut obtenir l’interface COM IWiaDrvItem en appelant wiasGetDrvItem. Après avoir obtenu cette interface, la méthode IWiaDrvItem::GetItemFlags peut être appelée pour déterminer le type d’élément WIA.

  2. Créez un tableau de noms de propriétés et d’ID de propriété qui décrivent le jeu de propriétés complet nécessaire sur l’élément actif. Après avoir créé ces tableaux, le minidriver WIA doit appeler la fonction de service wiasSetItemPropNames . Cette fonction indique au service WIA de créer un jeu de propriétés WIA basé sur les tableaux créés. Cette fonction doit toujours être appelée avant wiasWriteMultiple et wiasSetItemPropAttribs.

  3. Écrivez le paramètre initial, ou par défaut, dans le jeu de propriétés WIA nouvellement créé. Le minidriver WIA doit appeler la fonction de service wiasWriteMultiple pour définir les valeurs initiales. Cette fonction doit toujours être appelée avant wiasSetItemPropAttribs.

  4. Écrivez les valeurs valides et les droits d’accès pour chaque propriété. Le minidriver WIA doit appeler la fonction de service wiasSetItemPropAttribs pour définir les droits d’accès et les valeurs valides.

Les applications sont responsables de la lecture (et de la relecture) des propriétés dont elles dépendent, ce qui permet à l’application d’intercepter toutes les modifications apportées aux valeurs des propriétés. Les scanneurs et les caméras ont un ensemble de propriétés obligatoires. Ces propriétés sont répertoriées dans À propos des propriétés WIA.

Certaines propriétés ont des dépendances sur d’autres propriétés. Par exemple, la propriété format dépend de la propriété tyd. Ces dépendances inter-propriétés sont couvertes dans propriétés WIA.