Identification de la source d’entrée pour un événement d’analyse
Une opération d’analyse push est une opération d’analyse lancée par l’utilisateur à partir d’un appareil d’analyse WIA au lieu de l’interface utilisateur d’une application WIA s’exécutant sur un ordinateur de bureau. Lorsque l’utilisateur appuie sur le bouton démarrer-analyse sur l’appareil, l’application reçoit un événement d’analyse pour l’informer que l’utilisateur a demandé une opération d’analyse. En réponse à cet événement, l’application peut effectuer l’opération d’analyse push de l’une des deux manières suivantes :
Si l’appareil prend en charge l’analyse automatiquement configurée, l’application peut demander un transfert de données à partir de l’élément automatique pour acquérir une image à partir de la source d’entrée actuellement sélectionnée (à plat, chargeur automatique de documents ou adaptateur de numérisation de film). En réponse, l’appareil configure automatiquement ses paramètres d’analyse (à l’exception des quelques propriétés qui peuvent être configurées uniquement par l’application, qui sont décrites dans Propriétés WIA prises en charge par un élément automatique), puis acquiert l’image.
L’application peut effectuer l’opération d’analyse sous contrôle de programme direct. Tout d’abord, l’application configure les propriétés de l’élément WIA (élément à plat, élément de flux ou élément film) qui représente la source d’entrée actuellement sélectionnée. Ensuite, l’application acquiert une image en demandant un transfert de données à partir de cet élément.
Pour plus d’informations sur les éléments WIA, consultez Catégories d’éléments WIA.
Lorsqu’un événement d’analyse se produit, l’application reçoit une notification qui inclut un identificateur d’événement WIA (une valeur GUID) pour spécifier la nature de l’événement. Le minidriver WIA peut affecter un GUID d’identificateur d’événement WIA personnalisé à un événement, ou le minidriver peut utiliser l’une des constantes GUID WIA_EVENT_SCAN_XXX définies dans le fichier d’en-tête Wiadef.h. Pour plus d’informations sur ces constantes, consultez Identificateurs d’événements WIA.
Bien que l’identificateur d’événement WIA pour un événement d’analyse fournisse des informations sur l’événement, il n’identifie pas la source d’entrée à utiliser pour l’opération d’analyse. Pour l’analyse configurée automatiquement, l’application n’a pas besoin de ces informations. Toutefois, pour effectuer une analyse sous contrôle de programme direct, l’application doit savoir quelle source d’entrée utiliser. L’application doit disposer d’un moyen d’obtenir ces informations à partir de l’appareil si l’appareil a plusieurs sources d’entrée et que l’utilisateur peut sélectionner la source d’entrée à partir de l’appareil au lieu de partir de l’interface utilisateur de l’application. Lors de la sélection d’une source d’entrée à partir de l’appareil, l’utilisateur peut sélectionner la source de manière explicite (en appuyant sur un bouton sur le panneau frontal de l’appareil) ou implicitement (par exemple, en insérant un document dans un chargeur sur l’appareil).
Lorsqu’un événement d’analyse se produit, une application peut interroger la propriété WIA_DPS_SCAN_AVAILABLE_ITEM de l’appareil d’analyse WIA pour identifier la source d’entrée sélectionnée, si l’appareil prend en charge cette propriété. WIA_DPS_SCAN_AVAILABLE_ITEM est une propriété facultative de l’élément racine dans l’arborescence des éléments WIA d’un appareil. Pour plus d’informations sur cette propriété, consultez WIA_DPS_SCAN_AVAILABLE_ITEM.
Le pilote de classe d’analyse WSD implémente la propriété WIA_DPS_SCAN_AVAILABLE_ITEM en tant que fonctionnalité de pilote standard, comme décrit dans le paragraphe précédent, au lieu d’une extension de pilote personnalisée. Pour plus d’informations sur le pilote de classe d’analyse WSD, consultez WIA avec les services web pour appareils. Pour plus d’informations sur WDP pour les scanneurs, consultez Web Services for Devices Scan Service Schema.