WIA_DPS_SCAN_AVAILABLE_ITEM
Свойство WIA_DPS_SCAN_AVAILABLE_ITEM предоставляет имя источника входных данных для операции принудительного сканирования, выполняемой приложением под управлением программы. Мини-диск WIA создает и поддерживает это свойство.
Тип свойства: VT_BSTR
Допустимые значения: WIA_PROP_NONE
Права доступа: только для чтения
Комментарии
В Windows 7 и более поздних версиях WIA_DPS_SCAN_AVAILABLE_ITEM является необязательным свойством корневого элемента в дереве элементов WIA устройства сканера WIA. Приложение может запрашивать это свойство, чтобы определить источник входных данных (планшет, устройство автоматической подачи документов или адаптер для сканирования пленки), из который необходимо выполнить сканирование, или место хранения для передачи данных.
Некоторые устройства сканера WIA позволяют пользователю выбрать источник входных данных для задания сканирования на передней панели устройства или неявно выбрать источник входных данных, например путем вставки документа в канал на устройстве. Когда пользователь нажимает кнопку start-scan на устройстве, приложение должно определить, какой источник входных данных был выбран пользователем, чтобы запустить операцию сканирования в этом источнике.
Событие сканирования уведомляет приложение о том, что пользователь инициировал проверку, но событие не предоставляет имя элемента WIA, представляющего источник входных данных. Обработчик событий приложения может запросить свойство WIA_DPS_SCAN_AVAILABLE_ITEM корневого элемента, чтобы получить имя входного исходного элемента.
Корневой элемент в дереве WIA содержит один или несколько дочерних элементов (элемент с планшетом, элемент канала и элемент фильма), которые представляют источники входных данных на устройстве. Каждый из этих элементов может быть родительским по отношению к дочерним элементам, представляющим части или области источника входных данных. Элемент с планшетом, который является дочерним по отношению к корневому элементу и представляет планшет как целое, может иметь дочерние элементы (которые также являются элементами с планшетами), которые представляют отдельные области поверхности планшета. Элемент канала, который является дочерним по отношению к корневому элементу и представляет автоматическую передачу документов, может иметь дочерние элементы, представляющие сканеры для передней и задней сторон страниц документа, проходящих через канал. Элемент фильма, являющийся дочерним элементом корневого элемента и представляющий адаптер сканирования пленки в целом, может иметь дочерних элементов (которые также являются элементами пленки), которые представляют отдельные кадры пленки. В зависимости от операции сканирования, запрошенной пользователем, свойство WIA_DPS_SCAN_AVAILABLE_ITEM может называть объект flatbed, feeder или элемент фильма, который является дочерним элементом корня, или может называть дочерний элемент одного из этих элементов. Дополнительные сведения об этих элементах см. в разделе Категории элементов WIA.
При возникновении события сканирования драйвер немедленно задает для свойства WIA_DPS_SCAN_AVAILABLE_ITEM имя элемента WIA (точно так, как указано в свойстве WIA_IPA_ITEM_NAME элемента), которое определяет источник входных данных, из которого доступно задание сканирования, если эти сведения известны. В противном случае, если источник входных данных неизвестен, драйвер задает для свойства значение пустой строки. Когда приложение использует событие сканирования, состояние события сканирования изменяется с сигнального на несигнальное, а драйвер сбрасывает значение свойства WIA_DPS_SCAN_AVAILABLE_ITEM на пустую строку.
Дополнительные сведения об этом свойстве см. в разделе Определение источника входных данных для события сканирования.
Требования
Заголовок: wiadef.h (включая Wiadef.h)