Константы свойств устройства сканера
Аппаратные устройства с получением образов Windows (WIA) имеют значения свойств, которые хранятся в реестре Windows. Дополнительные сведения см. в разделе Общие константы свойств устройства. Следующие константы свойств устройства со связанными строками относятся к сканерам цифровых изображений.
Префикс "WIA_DPS_" обозначает свойство устройства для устройств сканера и является соглашением об именовании, используемым в C/C++. Для создания сценариев эти константы используют префикс ScannerDevice и являются частью перечисленного типа WiaItemPropertyId . Соответствующее имя члена из перечисления скрипта отображается в круглых скобках рядом с именем константы C/C++ в следующем списке.
Констант/значение | Описание | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Примечание. Это свойство поддерживается только в Windows Vista и более поздних версиях.
|
||||||||||||||||||||||||||||||||||||||
|
Зарезервировано, не используйте. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Зарезервировано, не используйте. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Содержит возможности сканера. Мини-диск создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить, установлен ли на сканере планшет, средство подачи документов или дуплексное устройство. Это свойство также используется для дальнейшего определения установленных компонентов. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице описаны константы, допустимые только в Windows 7.
В следующей таблице описаны константы, допустимые только в Windows 7 и Windows Vista.
В следующей таблице описаны константы, допустимые в Windows XP или более поздних версиях.
В следующей таблице описаны константы, допустимые только в Windows XP. Эти значения устарели для Windows 7 и Windows Vista и не должны использоваться.
|
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит текущий источник и режим получения сканера. Мини-диск создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить текущий источник получения сканера или записать это свойство, чтобы задать источник и режим проверки. Кроме того, приложения используют это свойство для включения и отключения функций дуплексера. Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_FLAG В следующей таблице содержится десять констант, допустимых с этим свойством.
|
||||||||||||||||||||||||||||||||||||||
|
Содержит текущее состояние установленного планшета сканера, средства подачи документов или дуплексера. Мини-driver создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить, готово ли устройство сканера к использованию. Это идеальный способ проверка, находится ли бумага в канале подачи перед получением изображения. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице содержатся константы, допустимые с этим свойством. Звездочка * указывает, что флаг не поддерживается в Windows Vista или более поздних версиях. Символ V указывает, что флаг поддерживается только в Windows Vista и более поздних версиях.
|
||||||||||||||||||||||||||||||||||||||
|
Содержит все допустимые символы, которые приложение может использовать для создания допустимых строк утвердителя. Индостер — это принтер, установленный на сканере, который печатает текстовое сообщение на каждой сканированной странице. Мини-диск должен проверить значение свойства WIA_DPS_ENDORSER_STRING на соответствие допустимому набору символов в этом свойстве. Мини-driver создает и поддерживает это свойство. Тип: VT_BSTR, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Содержит строку, которая должна быть одобрена (другими словами, напечатана) на каждой странице, которую проверяет мини-отвертка. Приложение задает это свойство с помощью допустимой кодировки, указанной в свойстве WIA_DPS_ENDORSER_CHARACTERS . Мини-диск должен поддерживать документы только в том случае, если в этом свойстве задана строка. Пустая строка означает, что функциональность утвердителя отключена. Так как за интерпретацию строки индостера отвечает драйвер, драйвер может использовать специальные символы в WIA_DPS_ENDORSER_STRING. Однако только приложения будут понимать эти символы. Тип: VT_BSTR, Access: чтение и запись, допустимые значения: WIA_PROP_NONE Драйвер, поддерживающий свойство WIA_DPS_ENDORSER_STRING , должен поддерживать следующий список маркеров.
|
||||||||||||||||||||||||||||||||||||||
|
Зарезервировано, не используйте. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит SOAP-адрес устройства сканера веб-служб. Мини-драйвер WIA 2.0 создает и поддерживает это свойство. Тип: VT_BSTR, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит регистрацию или выравнивание по горизонтали для документов, размещенных на планшете. Мини-driver создает и поддерживает это свойство. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице содержатся три константы, допустимые с этим свойством.
См. также: WIA_DPS_VERTICAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает максимальную ширину (в тысячных долях дюйма), которая сканируется по горизонтальной оси (X) от валенки планшетного сканера с текущим разрешением. Это свойство также применяется к автоматическим каналам подачи документов, которые перемещают листы на валенку планшетного сканера для сканирования. Это свойство является обязательным для сканеров, имеющих валин. Другие типы сканеров реализуют свойство WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE . Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает максимальную ширину (в тысячных долях дюйма), которая сканируется по горизонтальной оси (X) из карманного сканера или сканера канала листа в текущем разрешении. Это свойство также применяется к автоматическим каналам подачи документов, которые сканируют, не перемещая листы на валенку планшетного сканера. Это свойство является обязательным для сканеров на основе листов, прокрутки и ручных сканеров. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Содержит максимальное время сканирования одной страницы с текущими параметрами свойства в миллисекундах. Приложение считывает это свойство, чтобы оценить время, необходимое для сканирования страницы. Это полезно при определении условий устройства, которое перестало отвечать на запросы. Мини-driver создает и поддерживает это свойство. Это свойство является обязательным для всех сканеров. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит физические горизонтальные размеры наименьшей страницы, которую может сканировать средство подачи документов сканера, в тысячных долях дюйма. Мини-driver создает и поддерживает это свойство. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE См. также: WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит физические вертикальные размеры наименьшей страницы, которую может сканировать средство подачи документов сканера, в тысячных долях дюйма. Мини-driver создает и поддерживает это свойство. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE См. также: WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Горизонтальное оптическое разрешение. Максимальное поддерживаемо горизонтальное оптическое разрешение в DPI. Это свойство является одним значением. Это не список всех разрешений, которые могут быть созданы устройством. Скорее, это разрешение оптики устройства. Мини-driver создает и поддерживает это свойство. Это свойство является обязательным для всех сканеров. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Вертикальное оптическое разрешение. Максимальное поддерживаемо вертикальное оптическое разрешение в DPI. Это свойство является одним значением. Это не список всех разрешений, создаваемых устройством. Скорее, это разрешение оптики устройства. Мини-driver создает и поддерживает это свойство. Это свойство является обязательным для всех сканеров. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Содержит текущий параметр ориентации. Мини-driver создает и поддерживает это свойство. Приложение задает свойство WIA_DPS_ORIENTATION для определения исходной ориентации страницы или изображения для получения. Сведения об использовании WIA_DPS_ORIENTATION см. в разделе WIA_DPS_PAGE_SIZE Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST В следующей таблице содержатся четыре константы, допустимые с этим свойством.
См. также: |
||||||||||||||||||||||||||||||||||||||
|
Цвет, используемый для заливки, когда недостаточно данных изображения для заполнения запрошенного буфера. Это свойство реализовано для сканеров, которые заполняют буфер. Это свойство является необязательным для всех сканеров. Мини-диск создает и поддерживает это свойство. Тип: VT_UI1 | VT_VECTOR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE Формат сведений о цвете — RGBQUAD. |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит высоту выбранной страницы в тысячных долях дюйма. Мини-driver создает и сохраняет свойство WIA_DPS_PAGE_HEIGHT . Приложение считывает это свойство, чтобы определить физические размеры сканируемой страницы. Если параметры экстента отличаются от известных размеров страниц, это свойство сообщает высоту страницы, свойство WIA_DPS_PAGE_SIZE которой имеет значение WIA_PAGE_CUSTOM (которое является значением свойства WIA_DPS_PAGE_SIZE ). WIA_DPS_PAGE_HEIGHT должны быть синхронизированы с WIA_IPS_XEXTENT, которая сообщает высоту сканируемой страницы в пикселях. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит размер страницы, выбранной для сканирования. Чтобы выбрать размеры просматриваемой страницы, приложение задает это свойство. Мини-диск создает и поддерживает это свойство. Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST В следующей таблице приведены три константы, допустимые для этого свойства.
Значение свойства WIA_IPS_ORIENTATION определяет ориентацию текущей выбранной страницы. Свойства WIA_DPS_PAGE_WIDTH и WIA_DPS_PAGE_HEIGHT сообщают размеры страницы в тысячных долях дюйма. Обратите внимание, что эти свойства должны соответствовать WIA_IPS_XEXTENT и WIA_IPS_YEXTENT, которые содержат размеры страницы в пикселях. Допустимые значения типа WIA_PROP_LIST должны зависеть от допустимых параметров свойства WIA_IPS_ORIENTATION . Если устройство не может сканировать альбомно-ориентированные документы с помощью параметра WIA_PAGE_A4, WIA_PAGE_A4 не должны отображаться в списке допустимых значений свойства WIA_DPS_PAGE_SIZE , если для WIA_IPS_ORIENTATION задано значение LANSCAPE. Если приложение задает WIA_DPS_PAGE_SIZE любое значение, отличное от WIA_PAGE_CUSTOM, мини-диск должен настроить значения WIA_DPS_PAGE_WIDTH и WIA_DPS_PAGE_HEIGHT в соответствии с размерами страницы в тысячных долях дюйма. Он также должен настраивать значения WIA_IPS_XEXTENT и WIA_IPS_YEXTENT в соответствии с размерами страницы в пикселях. Если параметр экстента (WIA_IPS_XEXTENT или WIA_IPS_YEXTENT) изменяется на значение, которое не соответствует текущему параметру размера страницы, мини-диск должен изменить значение свойства WIA_DPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-диск также должен изменить WIA_DPS_PAGE_WIDTH или WIA_DPS_PAGE_HEIGHT в соответствии с новым параметром экстента. Если WIA_IPS_ORIENTATION задано значение LANSCAPE, параметры экстента будут "перевернуты". Например, если приложение задает для WIA_DPS_PAGE_SIZE значение WIA_PAGE_A4, мини-диск должен задать для WIA_DPS_PAGE_WIDTH значение 11692, а WIA_DPS_PAGE_HEIGHT — 8267. (Мини-диск также должен задавать WIA_IPS_XEXTENT и WIA_IPS_YEXTENT соответствующим образом.) Обратите внимание, что если для WIA_DPS_PAGE_SIZE задано значение WIA_PAGE_CUSTOM, параметр ориентации не используется для определения размеров экстентов сканируемой страницы. Мини-диск отвечает за то, чтобы свойство WIA_IPS_ORIENTATION соответствовало текущей области выбора. Если приложение изменяет значение WIA_IPS_ORIENTATION на недопустимое для текущего выбранного размера страницы, мини-диск должен изменить значение WIA_DPS_PAGE_SIZE на размер страницы, поддерживаемый новым значением ориентации. Если приложение задает для свойства WIA_DPS_PAGE_SIZE значение WIA_PAGE_CUSTOM, текущая область выбора не затрагивается. Мини-накопитель WIA должен получить текущий макет изображения, начиная с текущих параметров WIA_IPS_XPOS и WIA_IPS_YPOS свойств. Если параметр размера страницы приводит к выделению области, которая находится за пределами кровати сканера, мини-диск должен автоматически настроить значения WIA_IPS_XPOS и WIA_IPS_YPOS свойства до допустимых параметров. Если свойства WIA_DPS_PAGE_SIZE и WIA_IPS_ORIENTATION заданы одновременно и они недопустимы при применении в сочетании, мини-диск должен завершить настройку приложения, возвращая ошибку в IWiaMiniDrv::d rvValidateItemProperties. . В следующих четырех примерах показаны различные сценарии WIA_DPS_PAGE_SIZE .
Пример 1. Мини-диск сообщает о параметрах В следующем примере мини-диск задает настраиваемую область выбора перед тем, как приложение задает свойства WIA. В этом случае область выбора представляет всю область с планшетом.
Пример 2. Приложение задаетдля свойства WIA_DPS_PAGE_SIZE значение WIA_PAGE_LETTER
Пример 3. Приложение задаетдля свойства WIA_IPS_ORIENTATION значение LANSCAPE Физическая кровать должна иметь возможность получить страницу, которая изначально находилась в альбомной ориентации.
Пример 4. Приложение изменяет свойство WIA_IPS_XEXTENTна меньшее значение В следующем примере приложение изменяет свойство WIA_IPS_XEXTENT на 1000. Мини-накопитель должен предполагать, что новое значение, содержащееся в WIA_IPS_XEXTENT , больше не является допустимым для свойства WIA_DPS_PAGE_SIZE и поэтому должно изменить WIA_DPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-driver также должен настраивать WIA_DPS_PAGE_WIDTH.
|
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит ширину выбранной текущей страницы в тысячных долях дюйма. Приложение считывает это свойство, чтобы определить физические размеры сканируемой страницы. Если параметры экстентов отличаются от известных размеров страниц, это свойство сообщает ширину страницы, для свойства WIA_DPS_PAGE_SIZE которой задано значение WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH должны быть синхронизированы со значением WIA_IPS_XEXTENT, которое сообщает ширину сканируемой страницы в пикселях. Мини-диск создает и поддерживает это свойство. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит текущее количество страниц, получаемых из автоматического средства подачи документов. Мини-диск создает и поддерживает это свойство. Тип: VT_I4; Access: чтение и запись; Допустимые значения: WIA_PROP_RANGE (от нуля до максимального количества страниц, которое может хранить средство подачи документов) Приложение считывает это свойство, чтобы определить емкость страницы средства подачи документов. Приложение также задает для этого свойства количество страниц, которые оно будет сканировать.
Примечание. Один лист бумаги будет автоматически содержать две страницы, если параметр DUPLEX включен, даже если обратная сторона страницы пуста. Установка WIA_DPS_PAGES значения 1 приводит к тому, что сканер обработает одну из сторон страницы. Если сканер не может сканировать только одну сторону страницы в дуплексном режиме, WIA_DPS_PAGES допустимое значение элемента Inc структуры WIA_PROPERTY_INFO должно быть изменено на 2. Это значение сигнализирует приложению о том, что оно должно запрашивать страницы, кратные двум. Нулевое значение означает, что все страницы, загруженные в данный момент в средство подачи документов, должны быть отсканированы. |
||||||||||||||||||||||||||||||||||||||
|
Указывает цвет отсканированного листа в задней части листа. Это свойство является необязательным для сканеров, имеющих пластину. Мини-диск создает и поддерживает это свойство. Тип: VT_UI1 | VT_VECTOR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE Формат сведений о цвете — RGBQUAD. |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает режим предварительного просмотра для устройства. Приложение задает это свойство, чтобы поместить устройство в режим предварительного просмотра. Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST В следующей таблице содержатся две константы, допустимые с этим свойством.
|
||||||||||||||||||||||||||||||||||||||
|
Содержит значение, указывающее, будет ли сканер кэшировать страницы в буфере сканера перед их отправкой в приложение. Значение нуля отключает сканирование вперед, и страницы не будут проверяться заранее. При обычной передаче данных в буферизованном элементе упреждающего сканирования извлекаются буферизированные страницы. Свойства WIA нельзя изменить во время упреждающего сканирования. Это необязательное свойство. Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_RANGE от нуля до максимального количества страниц, которое может хранить средство подачи документов. |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает источник входных данных (планшет, устройство автоматической передачи документов или адаптер fil-scanning) для сканирования или место хранения для передачи данных. Событие сканирования уведомляет приложение о том, что пользователь инициировал проверку, но событие не предоставляет имя элемента WIA, представляющего источник входных данных. Обработчик событий приложения может запросить свойство WIA_DPS_SCAN_AVAILABLE_ITEM корневого элемента, чтобы получить имя входного исходного элемента. Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_RANGE от нуля до максимального количества страниц, которое может хранить средство подачи документов. |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит идентификатор службы устройства проверки веб-служб. Мини-драйвер WIA 2.0 создает и поддерживает это свойство. Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит сведения о регистрации или выравнивании и обнаружении границ для документов, размещенных на планшете. Мини-диск создает и поддерживает это свойство. Это свойство указывает, как лист расположен по горизонтали на сканирующей головке портативного или листового сканера. Свойство используется для прогнозирования расположения документа по всей области сканирования. Для сканеров, поддерживающих несколько головок сканирования, это свойство относится к верхней головке сканирования. Это свойство является обязательным для сканеров на основе листа, прокрутки и портативных сканеров. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице приведены три константы, допустимые для этого свойства.
|
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает, требуется ли элементу предварительного просмотра элемента управления, отображаемого для пользователя. Мини-диск создает и поддерживает это свойство. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице содержатся две константы, допустимые с этим свойством.
|
||||||||||||||||||||||||||||||||||||||
|
Примечание. Используется службой WIA для информирования мини-драйвера об имени учетной записи пользователя (включая доменное имя сети, если применимо) сеанса, в котором выполняется текущее приложение WIA. Это свойство корневого элемента, управляемое службой WIA. Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Содержит сведения о регистрации или вертикальном выравнивании и обнаружении ребер для документов, размещенных на планшете. Мини-диск создает и поддерживает это свойство. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице содержатся три константы, допустимые с этим свойством.
См. также. WIA_DPS_HORIZONTAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает максимальную высоту (в тысячных долях дюйма), которая сканируется по вертикальной оси (Y) от валенки планшетного сканера с текущим разрешением. Это свойство также применяется к автоматическим каналам подачи документов, которые перемещают листы на валенку планшетного сканера для сканирования. Это свойство является обязательным для сканеров, имеющих валин. Другие типы сканеров будут реализовывать свойство WIA_DPS_VERTICAL_SHEET_FEED_SIZE . Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
Примечание. Указывает максимальную высоту (в тысячных долях дюйма), которая сканируется по вертикальной оси (Y) из карманного сканера или сканера канала листа в текущем разрешении. Это свойство также применяется к автоматическим каналам подачи документов, которые сканируют, не перемещая листы на валенку планшетного сканера. Это свойство является обязательным для сканеров на основе листов. Это свойство не должно быть реализовано в сканерах, управляемых прокруткой, и ручных сканеров. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
Заголовок |
|