Категории элементов WIA

Этот раздел относится к Windows Vista и более поздних версий.

Все элементы в дереве элементов WIA должны поддерживать свойство WIA_IPA_ITEM_CATEGORY . Это свойство определяет функциональную категорию, к которой принадлежит элемент. Категория определяет набор флагов элементов WIA и свойств WIA, связанных с элементом.

WIA определяет следующие категории элементов:

WIA_CATEGORY_ROOT
Корневой элемент в дереве элементов для устройства сканера WIA представляет устройство в целом. Если устройство включает функцию сканирования плоской панели, ADF или пленки, элементы, представляющие эти источники входных данных, являются дочерними элементами корневого элемента. Если устройство содержит хранилище, самый верхний элемент папки в иерархии хранилища устройства является дочерним элементом корневого элемента. Приложение может получить доступ к сведениям об устройстве, включая состояние, идентификацию и права доступа, с помощью свойств WIA, реализованных в корневом элементе. Дополнительные сведения см. в обсуждениях свойств корневого элемента в разделах Implementing Flatbed Scanner Item Trees, Implementing Feeder Scanner Item Trees и Implementing Film Scanner Item Trees.

WIA_CATEGORY_FLATBED
Элемент с планшетом представляет собой планшет сканирования (также называемый сканируемой пластиной) на устройстве сканера WIA. Дерево элементов WIA для устройства с планшетом сканирования должно содержать элемент с планшетом, который является дочерним элементом корневого элемента. Кроме того, если устройство WIA поддерживает сегментацию (например, с помощью фильтра сегментации) или сканирование в нескольких регионах, этот элемент с планшетом должен иметь дочерние элементы, которые также являются элементами с планшетами, чтобы представлять отдельные области сканирования на планшете. Дочерние элементы, если они присутствуют, должны принадлежать к той же WIA_CATEGORY_FLATBED категории, что и их родительские, и они должны поддерживать те же свойства WIA (и иметь те же начальные значения свойств), что и родительские, за исключением того, что позиции и экстенты дочерних элементов ограничены областями сканирования, которые они представляют. Приложение может использовать фильтр сегментации драйвера WIA (если он указан) для создания областей сканирования, или мини-драйвер может автоматически обнаруживать и создавать сами регионы сканирования. Приложение может получить доступ к функции сканирования планшета устройства с помощью свойств WIA, реализованных в элементе с планшетом (или элементах). Дополнительные сведения см. в разделе Реализация деревьев элементов планшетного сканера.

WIA_CATEGORY_FEEDER
Элемент канала представляет собой автоматический канал подачи документов (ADF) на устройстве сканера WIA. (Эта категория элементов также может представлять подающее средство, которое не является полностью автоматическим и которое требует помощи вручную со стороны пользователя, но в этом случае мини-накопитель WIA отвечает за проверку того, что следующая страница документа была расширена через канал подачи перед сканированием страницы.) Устройство с ADF должно содержать элемент подателя в дереве элементов WIA. Элемент подающего элемента является дочерним по отношению к корневому элементу. Приложение может получить доступ к функции проверки ADF устройства с помощью свойств WIA, реализованных в элементе feeder. Дополнительные сведения см. в разделе Реализация деревьев элементов сканера канала.

Если ADF может выполнять дуплексное сканирование (т. е. сканировать обе стороны страницы документа) и поддерживает различные параметры управления для сканирования передней и задней сторон страницы документа, мини-диск WIA должен реализовать передний элемент feeder и элемент обратной части в качестве дочерних элементов элемента подателя. Приложение может получить доступ к функциям проверки переднего и заднего элементов ADF с помощью свойств WIA, реализованных на переднем элементе feeder и в обратном элементе. Дополнительные сведения об этих двух элементах см. в следующих описаниях категорий.

WIA_CATEGORY_FEEDER_FRONT
Передний элемент канала представляет параметры ADF для сканирования передней части страниц в документе. Этот элемент должен быть реализован мини-накопителем WIA для устройства сканера с ADF, которое может выполнять дуплексное сканирование и поддерживает различные параметры управления для сканирования передней и задней сторон страниц документа. Устройство с ADF, которое всегда использует одни и те же параметры для обеих сторон страниц документа, не нуждается в этом элементе. Передний элемент подателя является дочерним элементом элемента подателя. Приложение может получить доступ к функции проверки переднего интерфейса ADF через свойства WIA, реализованные в переднем элементе подателя. Дополнительные сведения см. в разделе Реализация деревьев элементов сканера канала.

WIA_CATEGORY_FEEDER_BACK
Элемент обратной подачи представляет параметры ADF для сканирования задней части страниц в документе. Этот элемент должен быть реализован мини-накопителем WIA для устройства сканера с ADF, которое может выполнять дуплексное сканирование и поддерживает различные параметры управления для сканирования передней и задней сторон страниц документа. Устройство с ADF, которое всегда использует одни и те же параметры для обеих сторон страниц документа, не нуждается в этом элементе. Элемент обратной подачи является дочерним элементом элемента подателя. Приложение может получить доступ к функции обратного сканирования ADF с помощью свойств WIA, реализованных в элементе обратной передачи. Дополнительные сведения см. в разделе Реализация деревьев элементов сканера канала.

WIA_CATEGORY_FILM
Элемент пленки представляет функцию сканирования пленки на устройстве сканера WIA. Устройство, представляющее собой специальный сканер пленки или сканер с планшетом, оснащенный адаптером прозрачности (TPA), должно содержать один или несколько элементов пленки в дереве элементов WIA. Элемент фильма является дочерним элементом корневого элемента или другого элемента фильма. Элемент пленки, который является дочерним элементом корневого элемента, представляет всю поверхность сканирования, и этот элемент пленки может содержать дочерние элементы, представляющие области поверхности сканирования, соответствующие отдельным кадрам пленки. Приложение может получить доступ к функции сканирования пленки устройства с помощью свойств WIA, реализованных в элементе пленки (или элементах). Дополнительные сведения см. в разделе Реализация деревьев элементов сканера пленки.

WIA_CATEGORY_FOLDER
Элемент папки представляет папку, расположенную во внутреннем хранилище устройства сканера WIA. Элемент папки является дочерним элементом корневого элемента или другого элемента папки. Если элемент папки имеет дочерние элементы, дочерние элементы представляют собой сочетание готовых элементов файлов и папок. Самый верхний элемент папки в дереве элементов является дочерним элементом корневого элемента. Приложение может получить доступ к содержимому папки и сведениям о ней с помощью свойств WIA, реализованных в элементе папки. Дополнительные сведения см. в разделе Хранилище сканера WIA.

WIA_CATEGORY_FINISHED_FILE
Элемент готового файла представляет собой готовый файл, хранящийся в папке на устройстве сканера WIA. Готовый файл — это файл, содержимое которого не изменяется. Это определение исключает файлы, содержимое которых может динамически изменяться, например, когда сканер получает и обрабатывает данные изображения. Элемент готового файла является дочерним по отношению к элементу папки. Приложение может получить доступ к готовому файлу и сведениям о файле с помощью свойств WIA, реализованных в элементе готового файла. Дополнительные сведения см. в разделе Хранилище сканера WIA.

WIA_CATEGORY_AUTO
В Windows 7 и более поздних версиях элемент auto представляет параметры автоматической конфигурации для устройства сканера WIA, поддерживающего автоматически настроенное сканирование. Этот тип устройства может настраивать собственные параметры сканирования, не требуя настройки параметров приложением WIA, работающим на настольном компьютере. Например, если устройство позволяет пользователю инициировать операцию сканирования с устройства (а не из пользовательского интерфейса приложения) и выбрать источник входных данных для операции с устройства, приложение может использовать автоматический элемент для разгрузки на устройство задачи настройки выбранного источника входных данных. Автоматический элемент является дочерним элементом корневого элемента. Дерево WIA, содержащее автоматический элемент, также должно содержать один или несколько из следующих элементов: элемент с планшетом, элемент feeder или элемент фильма. Приложение может получить доступ к автоматически настроенной функции сканирования устройства с помощью свойств WIA, реализованных в корневом элементе и в автоматическом элементе. Дополнительные сведения см. в разделе Свойства WIA, поддерживаемые автоматическим элементом.

Каждая категория элементов WIA имеет набор обязательных флагов элементов WIA и свойств WIA, которые должен поддерживать элемент в категории, а также набор флагов и свойств, которые элемент может поддерживать в качестве параметров. Сводку по флагам и свойствам, связанным с различными категориями элементов, см. в разделе WIA_IPA_ITEM_CATEGORY. Полный список флагов элементов WIA см. в разделе WIA_IPA_ITEM_FLAGS.