À propos de l’arborescence d’éléments IWiaItem2

avec Windows Vista, l’arborescence des éléments de l’Acquisition d’Image Windows (WIA) a changé de manière significative. Les éléments IWiaItem2 sont utilisés pour représenter des attributs d’appareil et des données de périphérique. les applications de création d’images voient un appareil WIA (Windows Image Acquisition) 2,0 comme une arborescence hiérarchique d’éléments, avec l’élément racine représentant l’appareil lui-même et les éléments enfants représentant des éléments tels que des sources de données programmables, des images ou des dossiers qui contiennent des images.

Éléments d’application

L’arborescence d’éléments WIA 2,0 qu’une application peut voir est distincte de l’arborescence créée et gérée par un minipilote WIA 2,0. Lorsqu’un minipilote crée une arborescence, le service WIA 2,0 utilise cette arborescence d’éléments WIA 2,0 comme guide pour créer une copie de l’arborescence qui peut être affichée par des applications de création d’images. Les éléments de l’arborescence copiée sont appelés éléments d' application . Les éléments de l’arborescence créés par un minipilote sont appelés éléments de pilote.

Un élément WIA peut représenter une source de données programmable pour le chargeur de documents d’un scanneur ou les données stockées sur cet appareil. Un appareil WIA doit être divisé en éléments individuels qui décrivent les différentes données produites par cet appareil.

Par exemple, un scanneur WIA qui prend en charge la numérisation à plat et l’analyse du flux de documents peut être divisé en deux éléments enfants. L’une représente la fonctionnalité d’analyse à plat et l’autre représente la fonctionnalité d’analyse du flux de documents.

Plusieurs images disposées sur un scanneur à plat et analysées en même temps peuvent être placées dans un dossier. À l’aide du filtre de segmentation (IWiaSegmentationFilter), chaque image ou sous-région peut ensuite être créée en tant qu’élément enfant du dossier.

L’arborescence WIA pour un appareil photo qui stocke des photos (« film ») peut être divisée en éléments qui représentent des dossiers, des sous-dossiers et des photos.

Indicateurs d’élément

Les indicateurs d’élément WIA aident à classifier le contenu ou le comportement pris en charge d’un élément WIA particulier. Les indicateurs d’élément WIA se répartissent en deux groupes.

  1. Les indicateurs d’état de l’élément signalent l’état actuel de l’élément WIA, par exemple WiaItemTypeDisconnected, WiaItemTypeDeleted, etc.
  2. Les indicateurs d’utilisation/représentation des données d’élément signalent les données que l’élément WIA représente ou peuvent produire en cas de transfert. Par exemple, WiaItemTypeImage est un indicateur de représentation de données qui indique à l’application que les données associées à l’élément WIA actuel sont des données image et doivent avoir des propriétés de données image. WIA _ Les _ _ indicateurs d’élément de la Loi sont un indicateur d’utilisation d’élément qui indique à l’application que l’élément WIA est configurable et qui suit un ensemble de règles de configuration prédéfinies basées sur la catégorie d’éléments de la _ Loi _ _ WIA et que la configuration peut éventuellement modifier le résultat pour chaque transfert de données. (Pour plus d’informations sur les définitions de catégorie, consultez catégories d’éléments catégories d’éléments. )

Le graphique suivant montre un exemple d’arborescence d’éléments WIA et les différents indicateurs qui peuvent être associés à chaque élément.

exemples d’indicateurs d’élément pour les éléments d’une arborescence

Catégories d’éléments

Les éléments WIA sont regroupés en catégories à l’aide des valeurs de propriété de _ _ _ catégorie d’élément WIA . Ces catégories définissent la façon dont un élément WIA doit être traité ou utilisé. Par exemple, si l’élément représente un fichier fini ( _ fichier de catégorie WIA _ terminé _ ), une application WIA doit supposer que les données sont statiques et situées sur l’appareil. Si l’élément représente un alimentation (chargeur de _ catégorie WIA _ ), l’application doit s’attendre à ce qu’elle contienne les propriétés du chargeur de documents requis et fonctionne comme un chargeur de documents.

Les catégories définies par WIA sont les suivantes :

  • WIA _ catégorie _ auto
  • _chargeur de catégorie WIA _
  • _film de catégorie WIA _
  • _fichier de catégorie WIA _ terminé _
  • _plateau de catégorie WIA _

Par exemple, l’élément à plat WIA d’un scanneur peut avoir les indicateurs d’élément de la _ Loi _ _ WIA définis sur WiaItemTypeImage, WiaItemTypeTransfer et WiaItemTypeProgrammableDataSource, et la propriété de _ _ _ catégorie d’élément WIA de l’acquisition d’images est définie sur le plateau de catégorie WIA _ _ .

Le tableau suivant montre le regroupement des catégories WIA avec les indicateurs d’élément et les éléments WIA. Cette table n’inclut pas une liste complète des indicateurs d’éléments WIA définis par WIA.

Catégorie WIA Indicateurs d’élément WIA valides Jeu de propriétés WIA Éléments WIA
WIA_CATEGORY_AUTO Le jeu de propriétés comprend les propriétés de l’analyseur configuré automatiquement. Élément auto WIA qui représente les paramètres d’analyse automatique configurés pour le scanneur.
WIA_CATEGORY_FEEDER Le jeu de propriétés comprend les propriétés du contrôle de l’analyseur du chargeur (généralement un jeu de propriétés d’image et de document spécifique). Éléments de chargeur WIA, y compris les éléments enfants qui représentent les pages frontale et précédente d’un document.
WIA_CATEGORY_FILM Le jeu de propriétés comprend les propriétés du contrôle scanner de film (généralement un jeu de propriétés d’image et de document spécifique). Éléments de film WIA, y compris les éléments enfants qui représentent les trames d’analyse individuelles.
WIA_CATEGORY_FINISHED_FILE La propriété définie sur cet élément dépend du type d’élément signalé. Par exemple, WiaItemTypeImage doit inclure des propriétés d’élément d’image, telles que les bits par pixel et ainsi de suite. Éléments de stockage WIA, y compris les éléments enfants qui représentent le contenu du fichier fini (fichiers de données tels que JPEG, HTML, TXT, etc.).
WIA_CATEGORY_FLATBED Le jeu de propriétés comprend des propriétés de contrôle de scanneur à plat (généralement un jeu de propriétés d’image et de document spécifique). Éléments à plat WIA, y compris les éléments enfants qui représentent des régions en cours d’analyse sur le plateau à plateau du scanneur.

Le graphique suivant montre un exemple d’arborescence d’éléments WIA et les différentes catégories qui peuvent être associées à chaque élément.

exemples de catégories d’éléments pour les éléments d’une arborescence

Élément racine

Un élément racine WIA est un élément de dossier marqué avec des indicateurs WiaItemTypeRoot et WiaItemTypeDevice qui représente l’appareil lui-même. Il contient des attributs d’appareil tels que le fabricant, le nom de périphérique et les attributs de pilote tels que la version de pilote et l’identificateur de classe d’interface utilisateur (CLSID). Les applications d’acquisition d’images obtiennent la racine de l’arborescence des éléments WIA en appelant la méthode IWiaDevMgr2 :: CreateDevice . L’application utilise l’élément racine pour accéder aux éléments WIA enfants individuels en énumérant l’arborescence (voir IEnumWiaItem2).

DataItem

Tout élément pouvant être utilisé pour transférer des données est considéré comme un élément de données. Cela comprend les éléments marqués avec l’indicateur WiaItemTypeProgrammableDataSource .

Les éléments de dossier et les éléments sans dossier peuvent exposer la possibilité de transférer des données en étant marqués avec l’indicateur WiaItemTypeTransfer . Tout élément avec cet indicateur doit fournir les propriétés d’élément WIA suivantes :

Les éléments de source de données programmables marqués avec l’indicateur WiaItemTypeTransfer doivent également fournir le jeu de propriétés d’élément de données requis.

Les éléments de données WIA peuvent avoir des propriétés supplémentaires en fonction des paramètres de l’indicateur de l’élément. Par exemple, les éléments WIA marqués avec l’indicateur WiaItemTypeImage doivent avoir des propriétés d’informations spécifiques à l’image, telles que WIA et le _ _ nombre _ de _ lignes WIA de la loi WIA. _ _

Informations de référence

IWiaItem2

IEnumWiaItem2

IWiaDevMgr2