WIA_DPS_SCAN_AVAILABLE_ITEM
La propriété WIA_DPS_SCAN_AVAILABLE_ITEM fournit le nom de la source d’entrée pour une opération d’analyse push que l’application effectue sous contrôle de programme. Le minidriver WIA crée et gère cette propriété.
Type de propriété : VT_BSTR
Valeurs valides : WIA_PROP_NONE
Droits d’accès : en lecture seule
Notes
Dans Windows 7 et versions ultérieures, WIA_DPS_SCAN_AVAILABLE_ITEM est une propriété facultative de l’élément racine dans l’arborescence d’éléments WIA d’un appareil de scanneur WIA. Une application peut interroger cette propriété pour déterminer la source d’entrée (à plat, chargeur automatique de documents ou adaptateur de numérisation de film) à partir de laquelle effectuer l’analyse, ou l’emplacement de stockage à partir duquel transférer des données.
Certains appareils de scanneur WIA permettent à un utilisateur de sélectionner une source d’entrée pour un travail d’analyse à partir du panneau frontal de l’appareil, ou de sélectionner implicitement une source d’entrée, par exemple, en insérant un document dans un chargeur sur l’appareil. Lorsque l’utilisateur appuie sur le bouton démarrer-analyse sur l’appareil, l’application doit déterminer la source d’entrée sélectionnée par l’utilisateur afin qu’elle puisse lancer une opération d’analyse sur cette source.
Un événement d’analyse informe l’application que l’utilisateur a lancé une analyse, mais l’événement ne fournit pas le nom de l’élément WIA qui représente la source d’entrée. Le gestionnaire d’événements de l’application peut interroger la propriété WIA_DPS_SCAN_AVAILABLE_ITEM de l’élément racine pour obtenir le nom de l’élément source d’entrée.
L’élément racine d’une arborescence WIA a un ou plusieurs éléments enfants (élément à plat, élément de chargeur et élément de film) qui représentent les sources d’entrée sur l’appareil. Chacun de ces éléments peut être un élément parent à enfant qui représente des parties ou des régions de la source d’entrée. Un élément à plat qui est un enfant de l’élément racine et qui représente le lit plat dans son ensemble peut avoir des enfants (qui sont également des éléments à plat) qui représentent les régions individuelles de la surface à plat. Un élément de chargeur qui est un enfant de l’élément racine et qui représente un chargeur de documents automatique peut avoir des enfants qui représentent les scanneurs pour les côtés avant et arrière des pages de document qui passent par le chargeur. Un élément de film qui est un enfant de l’élément racine et qui représente l’adaptateur de numérisation de film dans son ensemble peut avoir des enfants (qui sont également des éléments de film) qui représentent des images de film individuelles. Selon l’opération d’analyse demandée par l’utilisateur, la propriété WIA_DPS_SCAN_AVAILABLE_ITEM peut nommer un élément à plat, un chargeur ou un élément de film qui est un enfant de la racine, ou nommer un enfant de l’un de ces éléments. Pour plus d’informations sur ces éléments, consultez Catégories d’éléments WIA.
Lorsqu’un événement d’analyse se produit, le pilote définit immédiatement la valeur de la propriété WIA_DPS_SCAN_AVAILABLE_ITEM sur un nom d’élément WIA (exactement comme indiqué par la propriété WIA_IPA_ITEM_NAME de l’élément) qui identifie la source d’entrée à partir de laquelle le travail d’analyse est disponible, si ces informations sont connues. Sinon, si la source d’entrée est inconnue, le pilote définit la valeur de la propriété sur une chaîne vide. Lorsque l’application consomme l’événement d’analyse, l’état de l’événement d’analyse passe de signal à non signalé, et le pilote réinitialise la valeur de la propriété WIA_DPS_SCAN_AVAILABLE_ITEM à une chaîne vide.
Pour plus d’informations sur cette propriété, consultez Identification de la source d’entrée pour un événement d’analyse.
Spécifications
En-tête : wiadef.h (inclure Wiadef.h)