Константы свойств элементов WIA сканера

Статья
06/13/2023

Следующие константы указывают допустимый набор свойств элемента средства проверки получения образов Windows (WIA).

Префикс "WIA_IPS_" указывает на свойство элемента для устройств сканера и является соглашением об именовании, используемым в C/C++. В целях создания скриптов эти константы используют префикс "ScannerPicture" и являются частью перечисленного типа WiaItemPropertyId . Соответствующее имя члена из перечисления скрипта отображается в круглых скобках рядом с именем константы C/C++ в следующем списке.

Констант/значение Описание

WIA_IPS_AUTO_DESKEW
ScannerPictureAutoDeskew

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

Включает или выключает автоматический рабочий стол.
Необязательный параметр только для WIA_CATEGORY_FEEDER.
Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST
В следующей таблице содержатся константы, допустимые для этого свойства.

Константа	Описание
WIA_AUTO_DESKEW_ON	Включите автоматический рабочий стол.
WIA_AUTO_DESKEW_OFF	Выключите автоматический рабочий стол.

WIA_IPS_BRIGHTNESS
ScannerPictureBrightness

Значения яркости изображения, доступные в сканере.

Содержит текущий параметр яркости оборудования для устройства. Приложение задает этому свойству значение яркости оборудования. Мини-диск создает и поддерживает это свойство.

Значения должны сопоставляться в диапазоне от –1000 до 1000, где 1000 соответствует максимальной яркости, 0 — нормальной яркости, а –1000 — минимальной яркости.

Требуется для всех элементов в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM. Необязательный, но рекомендуемый для WIA_CATEGORY_FINISHED_FILE элементов, поддерживающих предварительные версии.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_CONTRAST
ScannerPictureContrast

Содержит текущий параметр аппаратной контрастности для устройства. Приложение присваивает этому свойству значение контрастности оборудования. Мини-диск создает и поддерживает это свойство.

Значения должны быть сопоставлены в диапазоне от -1000 до 1000, где -1000 соответствует минимальной контрастности, 0 — нормальной контрастности, а 1000 — максимальной контрастности.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_CUR_INTENT
ScannerPictureCurIntent

Содержит текущие параметры намерения. Мини-диск создает и поддерживает это свойство.

Требуется для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM. Он не поддерживается для элементов WIA_CATEGORY_FINISHED_FILE или WIA_CATEGORY_FOLDER.

Тип: VT_I4 Access: чтение и запись, допустимые значения: WIA_PROP_FLAGS

Драйвер использует их для предустановки свойств элемента на основе предполагаемого использования изображения приложением. Это может быть, например, максимальное качество, минимальный размер и т. д.

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

Приложение задает это свойство для автоматического задания свойств WIA для конкретного намерения приобретения.

Примечание.
Флаги можно сочетать с побитовым оператором OR , но изображение не может быть одновременно оттенком серого и цветом.

Это свойство является обязательным для всех сканеров.

В следующей таблице содержатся флаги типа изображения и их определения. Эти флаги используются для задания типа изображения: цвет, оттенки серого и т. д.

Флаги предполагаемого типа изображения	Описание
WIA_INTENT_NONE	Значение по умолчанию. Намерение не указано.
WIA_INTENT_IMAGE_TYPE_COLOR	Приложение намерено подготовить устройство к цветовой проверке.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE	Приложение намерено подготовить устройство к сканированию в оттенках серого.
WIA_INTENT_IMAGE_TYPE_TEXT	Приложение намерено подготовить устройство к сканированию текста.
WIA_INTENT_IMAGE_TYPE_MASK	Маска для всех флагов типа изображения.

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

Предполагаемые флаги размера и качества изображения	Описание
WIA_INTENT_MINIMIZE_SIZE	Приложение намерено подготовить устройство к сканированию изображения, результатом чего является небольшое сканирование.
WIA_INTENT_MAXIMIZE_QUALITY	Приложение намерено подготовить устройство к сканированию высококачественного изображения.
WIA_INTENT_SIZE_MASK	Этот флаг является маской для всех флагов размера и качества.
WIA_INTENT_BEST_PREVIEW	Приложение намерено подготовить устройство к проверке предварительной версии.

WIA_IPS_DESKEW_X
ScannerPictureDeskewX

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

Содержит количество пикселей в направлении x от WIA_IPS_XPOS до координаты X верхнего угла изображения, который необходимо создать. Таким образом, в сочетании с WIA_IPS_DESKEW_Y описывается, где два верхних угла искаженного изображения находятся в ограничивающем прямоугольнике, определенном WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT и WIA_IPS_YEXTENT. его свойство реализуется драйвером сканера, если он поддерживает deskewing.

Допустимые значения для WIA_IPS_DESKEW_X должны находиться в диапазоне от 0 до (WIA_IPS_XEXTENT –1). Значение 0 означает, что не следует выполнять рабочий стол.

Это свойство является необязательным для элементов категорий WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER и WIA_CATEGORY_FILM; и недоступен для WIA_CATEGORY_FINISHED_FILE или WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_DESKEW_Y
ScannerPictureDeskewY

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

Содержит количество пикселей в направлении Y от WIA_IPS_YPOS до координаты Y крайнего левого угла изображения, который необходимо создать. Таким образом, в сочетании с WIA_IPS_DESKEW_X описывается, где два верхних угла искаженного изображения расположены в ограничивающем прямоугольнике, определенном WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT и WIA_IPS_YEXTENT. Это свойство реализуется драйвером сканера, если он поддерживает функцию deskewing.

Допустимые значения для WIA_IPS_DESKEW_Y должны находиться в диапазоне от 0 до (WIA_IPS_YEXTENT –1). Значение 0 означает, что не следует выполнять рабочий стол.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_DOCUMENT_HANDLING_SELECT
ScannerPictureDocumentHandlingSelect

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

Содержит текущий источник и режим получения сканера. Мини-диск создает и поддерживает это свойство.

Приложение считывает это свойство, чтобы определить текущий источник получения сканера или записать это свойство, чтобы задать источник и режим проверки. Кроме того, приложения используют это свойство для включения и отключения функций дуплексера.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_FLAG

В следующей таблице содержатся константы, допустимые для этого свойства.

Флаги	Описание
ДУПЛЕКС	Сканирование с помощью дуплексных операций. Проверьте обе стороны документа с помощью общих параметров, настроенных для элемента средства подачи (WIA_CATEGORY_FEEDER). Duplex и ADVANCE_DUPLEX нельзя одновременно задать.
ADVANCED_DUPLEX	Проверка с использованием отдельных параметров, настроенных для каждого дочернего элемента канала (WIA_CATEGORY_FEEDER_FRONT и WIA_CATEGORY_FEEDER_BACK). Duplex и ADVANCE_DUPLEX нельзя одновременно задать.
FRONT_FIRST	Сначала просканируйте переднюю часть документа. Это значение допустимо, если задано значение DUPLEX или ADVANCED_DUPLEX.
BACK_FIRST	Сначала отсканируйте заднюю часть документа. Это значение допустимо, если задано значение DUPLEX или ADVANCED_DUPLEX.
FRONT_ONLY	Сканирование только передней части.
BACK_ONLY	Сканируйте только обратную сторону. Это значение допустимо, если задано значение DUPLEX или ADVANCED_DUPLEX.

WIA_IPS_FILM_NODE_NAME
ScannerPictureFilmNodeName

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

Включает спецификацию конкретного вложения для сканирования пленки, если их несколько.

Это свойство является обязательным для WIA_CATEGORY_FILM элементов при наличии нескольких элементов сканирования пленки. Если устройство поддерживает только один элемент пленки корневого сканера, это свойство является необязательным.

Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

Допустимые значения. BSTR должна иметь вид @ResourceBinary,-<ResourceID> , чтобы разрешить локализацию, так как эта строка будет доступна пользователю через пользовательский интерфейс сканирования пленки.

WIA_IPS_FILM_SCAN_MODE
ScannerPictureFilmScanMode

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

Включает настройку текущего сканирования пленки.

Это свойство является обязательным для элемента WIA_CATEGORY_FILM.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся константы, допустимые для этого свойства.

Константа	Описание
WIA_FILM_COLOR_SLIDE	Проверка цветного слайда.
WIA_FILM_COLOR_NEGATIVE	Проверка на наличие отрицательного цвета.
WIA_FILM_BW_NEGATIVE	Проверка на наличие черно-белых отрицательных значений.

WIA_IPS_INVERT
ScannerPictureInvert

Зарезервировано для использования в будущем и в настоящее время не реализовано.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
ScannerPictureInvert

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

Указывает, сколько элементов хранится в элементе WIA_CATEGORY_FOLDER.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_LAMP
ScannerPictureLamp

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

Включает или выключает лампу сканера.

Необязательный для элементов WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER и WIA_CATEGORY_FILM и рекомендуется для WIA_CATEGORY_FILM.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся константы, допустимые для этого свойства.

Константа	Описание
WIA_LAMP_ON	Включите лампу.
WIA_LAMP_OFF	Выключите лампу.

WIA_IPS_LAMP_AUTO_OFF
ScannerPictureLampAutoOff

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

Задает максимальное время для включения лампы, когда сканер не используется.

Необязательный для элементов WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER и WIA_CATEGORY_FILM и рекомендуется для WIA_CATEGORY_FILM.

Тип: VT_UI4, Access: чтение и запись, допустимые значения: 0–0xFFF секунд

WIA_IPS_MAX_HORIZONTAL_SIZE
ScannerPictureMaxHorizontalSize

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

Указывает максимальную ширину в тысячных долях дюйма, которая сканируется по горизонтальной оси (X) в текущем разрешении. Это может быть ширина подающего листа или сканирующей кровати в зависимости от типа элемента.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_MAX_VERTICAL_SIZE
ScannerPictureMaxVerticalSize

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

Указывает максимальную высоту в тысячных долях дюйма, которая сканируется по вертикальной оси (Y) в текущем разрешении. Это может быть высота подающего листа или сканирующей кровати в зависимости от типа элемента.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_MIN_HORIZONTAL_SIZE
ScannerPictureMinHorizontalSize

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

Указывает минимальную ширину в тысячных долях дюйма, которая сканируется по горизонтальной оси (X) в текущем разрешении.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_MIN_VERTICAL_SIZE
ScannerPictureMinVerticalSize

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

Указывает минимальную высоту в тысячных долях дюйма, которая сканируется по вертикальной оси (Y) в текущем разрешении.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_MIRROR
ScannerPictureMirror

Зарезервировано для использования в будущем и в настоящее время не реализовано.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_OPTICAL_XRES
ScannerPictureOpticalXres

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

Горизонтальное оптическое разрешение. Максимальное поддерживаеме горизонтальное оптическое разрешение в DPI. Это свойство является одним значением. Это не список всех разрешений, которые могут быть созданы устройством. Скорее, это разрешение оптики устройства. Мини-диск создает и поддерживает это свойство. Это свойство является обязательным для всех элементов.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_OPTICAL_YRES
ScannerPictureOpticalYres

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

Вертикальное оптическое разрешение. Максимальное поддерживаемо вертикальное оптическое разрешение в DPI. Это свойство является одним значением. Это не список всех разрешений, созданных устройством. Скорее, это разрешение оптики устройства. Мини-диск создает и поддерживает это свойство. Это свойство является обязательным для всех элементов.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_ORIENTATION
ScannerPictureOrientation

Указывает текущую ориентацию проверяемых документов. Мини-диск создает и поддерживает это свойство.

Приложение задает это свойство, чтобы определить исходную ориентацию страницы или изображения, которые необходимо получить. Сведения об использовании WIA_IPS_ORIENTATION см. в разделе WIA_IPS_PAGE_SIZE.

Примечание.
WIA_IPS_ORIENTATION относится к положению документа, который должен быть отсканирован на кровати сканера или на подателях. Это ориентация документа относительно направления сканирования. WIA_IPS_ROTATION относится к повороту, который применяется к изображению после его сканирования непосредственно перед передачей изображения в приложение.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся четыре константы, допустимые с этим свойством.

Значение	Определение
ПОРТРЕТ	0 градусов.
LANDSCAPE	Поворот на 90 градусов против часовой стрелки относительно ориентации PORTRAIT.
ROT180	Поворот на 180 градусов против часовой стрелки относительно ориентации PORTRAIT.
ROT270	Поворот на 270 градусов против часовой стрелки относительно ориентации PORTRAIT.

WIA_IPS_PAGE_SIZE
ScannerPicturePageSize

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

Содержит размер страницы, которая в настоящее время настроена для сканирования. Приложение задает это свойство для выбора размеров просматриваемой страницы. Мини-диск создает и поддерживает это свойство.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

Константы, которые можно использовать с этим свойством, см. в разделе Константы размера страницы WIA 2.0. Обратите внимание на следующие нефиксные размеры, в частности:

Значение	Определение
WIA_PAGE_CUSTOM	Определяется значениями свойств WIA_IPS_PAGE_HEIGHT и WIA_IPS_PAGE_WIDTH .
WIA_PAGE_AUTO	Размер страницы автоматически определяется устройством.
WIA_PAGE_CUSTOM_BASE	Пользовательский размер страницы, размеры которого уже известны приложению и драйверу устройства.

Значение свойства WIA_IPS_ORIENTATION определяет ориентацию текущей выбранной страницы. Свойства WIA_IPS_PAGE_WIDTH и WIA_IPS_PAGE_HEIGHT сообщают размеры страницы в тысячных долях дюйма. Эти свойства должны соответствовать WIA_IPS_XEXTENT и WIA_IPS_YEXTENT, которые содержат размеры страницы в пикселях.

Примечание.
Допустимые значения типа WIA_PROP_LIST зависят от допустимых параметров свойства WIA_IPS_ORIENTATION . Например, если устройство не может сканировать альбомно-ориентированные документы с помощью параметра WIA_PAGE_A4, WIA_PAGE_A4 не является допустимым значением свойства WIA_IPS_PAGE_SIZE , если для WIA_IPS_ORIENTATION задано значение LANDSCAPE.

Если приложение задает для WIA_IPS_PAGE_SIZE любое значение, отличное от трех значений в таблице выше, мини-диск должен настроить значения WIA_IPS_PAGE_WIDTH и WIA_IPS_PAGE_HEIGHT в соответствии с размерами страницы в тысячных долях дюйма. Он также должен настроить значения WIA_IPS_XEXTENT и WIA_IPS_YEXTENT в соответствии с размерами страницы в пикселях.

Если параметр экстента (WIA_IPS_XEXTENT или WIA_IPS_YEXTENT) изменяется на значение, которое не соответствует текущему параметру размера страницы, мини-диск должен изменить значение свойства WIA_IPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-диск также должен изменять WIA_IPS_PAGE_WIDTH или WIA_IPS_PAGE_HEIGHT в соответствии с новым параметром экстента.

Если для WIA_IPS_ORIENTATION задано значение LANDSCAPE, параметры экстента будут заменены относительно их обычных значений. Например, если приложение задает для WIA_IPS_PAGE_SIZE значение WIA_PAGE_A4, мини-диск устанавливает для WIA_IPS_PAGE_WIDTH значение 11692, а WIA_IPS_PAGE_HEIGHT — на 8267. (Мини-отвертка также должна соответствующим образом настроить WIA_IPS_XEXTENT и WIA_IPS_YEXTENT .)

Примечание.
Если для WIA_IPS_PAGE_SIZE задано значение WIA_PAGE_CUSTOM, параметр ориентации не используется для определения размеров экстентов проверяемой страницы.

Мини-отвертка отвечает за соответствие свойства WIA_IPS_ORIENTATION текущей области выбора. Если приложение изменяет значение WIA_IPS_ORIENTATION на недопустимое для текущего выбранного размера страницы, мини-накопитель должен изменить значение WIA_IPS_PAGE_SIZE на размер страницы, поддерживаемый новым значением ориентации.

Если приложение задает для свойства WIA_IPS_PAGE_SIZE значение WIA_PAGE_CUSTOM, текущая область выбора не затрагивается. Мини-диск WIA должен получить текущий макет изображения, начиная с текущих параметров WIA_IPS_XPOS и WIA_IPS_YPOS свойств. Если параметр размера страницы приводит к выделению области, которая находится за пределами кровати сканера, мини-диск должен автоматически настроить значения WIA_IPS_XPOS и свойства WIA_IPS_YPOS до допустимых параметров. Если свойства WIA_IPS_PAGE_SIZE и WIA_IPS_ORIENTATION заданы одновременно и они недопустимы при применении в сочетании, мини-driver должен завершиться ошибкой параметров приложения, возвращая ошибку в IWiaMiniDrv::d rvValidateItemProperties.

В следующих четырех примерах показаны различные сценарии WIA_IPS_PAGE_SIZE .

Драйвер сообщает о параметрах.
Приложение задает для свойства WIA_IPS_PAGE_SIZE значение WIA_PAGE_LETTER.
Приложение задает свойству WIA_IPS_ORIENTATION значение LANDSCAPE.
Приложение изменяет свойство WIA_IPS_XEXTENT на меньшее значение.

Пример 1. Мини-driver сообщает о параметрах

В следующем примере мини-driver задает настраиваемую область выбора до того, как приложение задает любые свойства WIA. В этом случае область выбора представляет всю область планшета.

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_WIDTH = 11500
WIA_IPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Пример 2. Приложение задаетдля свойства WIA_IPS_PAGE_SIZE значение WIA_PAGE_LETTER

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Пример 3. Приложение присваивает свойствуWIA_IPS_ORIENTATIONзначение LANDSCAPE

Физическая кровать должна иметь возможность получить страницу, которая изначально находилась в альбомной ориентации.

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Пример 4. Приложение изменяет свойство WIA_IPS_XEXTENTна меньшее значение

В следующем примере приложение изменяет свойство WIA_IPS_XEXTENT на 1000. Мини-диск должен предполагать, что новое значение, содержащееся в WIA_IPS_XEXTENT , больше не является допустимым для свойства WIA_IPS_PAGE_SIZE и поэтому должно измениться WIA_IPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-диск также должен настраивать WIA_IPS_PAGE_WIDTH.

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_HEIGHT = 10000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

WIA_IPS_PAGE_HEIGHT
ScannerPicturePageHeight

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

Содержит высоту выбранной в данный момент страницы в тысячных долях дюйма. Мини-диск создает и обслуживает свойство WIA_IPS_PAGE_HEIGHT . Приложение считывает это свойство, чтобы определить физические размеры проверяемой страницы. Если параметры экстента отличаются от известных размеров страниц, это свойство сообщает высоту страницы, для свойства WIA_IPS_PAGE_SIZE которой задано значение WIA_PAGE_CUSTOM (которое является значением свойства WIA_IPS_PAGE_SIZE ). WIA_IPS_PAGE_HEIGHT должны быть синхронизированы с WIA_IPS_XEXTENT, которая сообщает высоту сканируемой страницы в пикселях.

Это свойство является обязательным для WIA_CATEGORY_FEEDER элементов.

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_PAGE_WIDTH
ScannerPicturePageWidth

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

Содержит ширину выбранной текущей страницы в тысячных долях дюйма. Приложение считывает это свойство, чтобы определить физические размеры проверяемой страницы. Если параметры экстента отличаются от известных размеров страниц, это свойство сообщает ширину страницы, для свойства WIA_IPS_PAGE_SIZE которой задано значение WIA_PAGE_CUSTOM. WIA_IPS_PAGE_WIDTH должны быть синхронизированы со значением WIA_IPS_XEXTENT, которое сообщает ширину сканируемой страницы в пикселях. Мини-driver создает и поддерживает это свойство.

Это свойство является обязательным для WIA_CATEGORY_FEEDER элементов.

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_PAGES
ScannerPicturePages

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

Содержит текущее количество страниц для получения из автоматического средства подачи документов. Мини-driver создает и поддерживает это свойство.

Тип: VT_I4; Доступ: чтение и запись; Допустимые значения: WIA_PROP_RANGE Это равно нулю до максимального количества страниц, которое может сканировать сканер. Значение равно ALL_PAGES (= 0), если сканер может сканировать непрерывно.

Приложение считывает это свойство, чтобы определить емкость страницы средства подачи документов. Приложение также задает для этого свойства количество страниц, которые оно будет сканировать.

Примечание.
Если включен дуплексный режим (WIA_IPS_DOCUMENT_HANDLING_SELECT задано значение FEEDER | DUPLEX | ADVANCED_DUPLEX), WIA_IPS_PAGES по-прежнему равно количеству просматриваемых страниц.

Если параметр DUPLEX включен, один лист будет автоматически содержать две страницы, даже если задняя сторона страницы пуста.

Если задать WIA_IPS_PAGES значение 1, сканер обработает одну сторону страницы. Если сканер не может сканировать только одну сторону страницы в дуплексном режиме, измените значение WIA_IPS_PAGES элемента Inc элемента Range структуры WIA_PROPERTY_INFO на 2. Это значение сигнализирует приложению о том, что оно должно запрашивать страницы, кратные двум. Значение ALL_PAGES (= 0) означает, что сканируются все страницы, загруженные в средство подачи документов.

WIA_IPS_PHOTOMETRIC_INTERP
ScannerPicturePhotometricInterp

Содержит текущий параметр для белых и черных пикселей. Мини-driver создает и поддерживает это свойство.

Приложение считывает это значение, чтобы определить значение WHITE или BLACK (в зависимости от того, что делает приложение).

Требуется для всех элементов, включенных или хранимых в приобретении; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_FILM. Он не поддерживается для WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4; Доступ: чтение и запись; Допустимые значения: WIA_PROP_LIST. Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение.

В следующей таблице приведены две константы, допустимые для этого свойства.

Значение	Определение
WIA_PHOTO_WHITE_0	WHITE имеет значение 0, а BLACK — 1.
WIA_PHOTO_WHITE_1	WHITE имеет значение 1, а BLACK — 0.

WIA_IPS_PREVIEW
ScannerPicturePreview

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

Указывает режим предварительного просмотра для устройства. Приложение задает это свойство, чтобы поместить устройство в режим предварительного просмотра.

Это свойство является обязательным для элементов WIA_CATEGORY_FLATBED и WIA_CATEGORY_FILM, необязательно для элемента WIA_CATEGORY_FEEDER.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся константы, допустимые с этим свойством.

Значение	Определение
WIA_FINAL_SCAN	Приложение выполнит окончательную проверку.
WIA_PREVIEW_SCAN	Приложение выполнит предварительную проверку.

WIA_IPS_PREVIEW_TYPE
ScannerPicturePreviewType

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

Указывает, можно ли обновить существующий образ предварительного просмотра во время предварительного просмотра изображения (в ответ на изменение свойств WIA_IPA_DATATYPE или WIA_IPA_DEPTH).

Это свойство является необязательным для всех элементов с поддержкой приобретения, поддерживающих предварительные проверки; то есть WIA_IPS_PREVIEW поддерживается с WIA_PREVIEW_SCAN. Сюда входят элементы типов WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM.

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

В следующей таблице содержатся константы, допустимые с этим свойством.

Константа	Описание
WIA_ADVANCED_PREVIEW	Возможно обновление существующего образа.
WIA_BASIC_PREVIEW	Необходимо выполнить еще одну предварительную проверку, так как обновление существующего образа невозможно.

WIA_IPS_ROTATION
ScannerPictureRotation

Содержит текущий параметр поворота, если он реализован. Мини-driver создает и поддерживает это свойство.

Приложение задает это свойство, чтобы сообщить драйверу, сколько (если вообще) нужно повернуть изображение, прежде чем драйвер вернет его в приложение.

Примечание.
WIA_IPS_ORIENTATION относится к положению документа, который должен быть отсканирован на кровати сканера или в канале подачи. Это ориентация документа относительно направления сканирования. WIA_IPS_ROTATION относится к повороту, который применяется к изображению после его сканирования непосредственно перед передачей изображения в приложение.

Мини-диск WIA отвечает за смену данных изображения перед их отправкой обратно в приложение. Приложение отвечает за проверку заголовков изображений для просмотра новых повернутых значений.

Существует значительная путаница в устранении влияния поворота на область выбора текущего изображения (которая определяется свойствами WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT и WIA_IPS_YEXTENT).

Область выбора относится к выбранной области на физической кровати сканера, из которую извлекается изображение. WIA_IPS_ROTATION не изменяет область выбора. Драйвер применяет поворот против часовой стрелки в соответствии с WIA_IPS_ROTATION только после того, как драйвер получил соответствующую область выбора. WIA_IPS_ROTATION влияет на размеры выходного изображения, поэтому эти измерения должны отражаться в заголовке данных результирующего изображения.

Необязательный параметр для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

Определены следующие константы поворота.

Константа	Определение
ПОРТРЕТ	Драйвер не будет поворачивать образ.
LANDSCAPE	Т. Драйвер поворачивает изображение на 90 градусов против часовой стрелки.
ROT180	Драйвер поворачивает изображение на 180 градусов против часовой стрелки.
ROT270	Драйвер поворачивает изображение на 270 градусов против часовой стрелки.

WIA_IPS_SEGMENTATION
ScannerPictureSegmentation

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

Указывает, должно ли приложение использовать фильтр сегментации драйвера для сканирования в нескольких регионах. WIA_IPS_SEGMENTATION должны быть реализованы для WIA_CATEGORY_FLATBED и WIA_CATEGORY_FILM элементов, если они поддерживают создание дочерних элементов с фильтром сегментации или если драйвер сам создает дочерние элементы для фиксированных кадров.

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

В следующей таблице приведены две константы, допустимые для этого свойства.

Значение	Определение
WIA_USE_SEGMENTATION_FILTER	Приложение должно использовать фильтр сегментации для сканирования в нескольких регионах.
WIA_DONT_USE_SEGMENTATION_FILTER	Драйвер сам создает дочерние элементы для сканирования в нескольких регионах. Обычно это происходит, если сканер использует фиксированные кадры для этой цели.

Примечание.
Драйвер может поставиться с фильтром сегментации, но WIA_IPS_SEGMENTATION по-прежнему имеет значение WIA_DONT_USE_SEGMENTATION_FILTER для одного из его элементов (например, элемента WIA_CATEGORY_FILM). Это может произойти, если сканер использует фиксированные кадры для сканирования пленки, но не для регулярного сканирования WIA_CATEGORY_FLATBED элементов.

WIA_IPS_SHEET_FEEDER_REGISTRATION
ScannerPictureSheetFeederRegistration

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

Содержит регистрацию или определение выравнивания и ребер для документов, размещенных на планшете. Мини-driver создает и поддерживает это свойство. Это свойство указывает, как лист располагается по горизонтали на сканирующей голове ручного или листового сканера. Свойство используется для прогнозирования расположения документа в области сканирования.

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

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

В следующей таблице содержатся три константы, допустимые с этим свойством.

Константа	Описание
LEFT_JUSTIFIED	Лист расположен слева относительно сканирующей головки.
ЦЕНТРЕ	Лист находится в центре сканирующей головки.
RIGHT_JUSTIFIED	Лист расположен справа относительно сканирующей головки.

WIA_IPS_SHOW_PREVIEW_CONTROL
ScannerPictureShowPreviewControl

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

Указывает, требуется ли элементу предварительного просмотра элемента управления, отображаемого для пользователя. Мини-driver создает и поддерживает это свойство.

Необязательный параметр для всех элементов с поддержкой передачи. Обычно это только элементы категорий WIA_ITEM_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM и WIA_CATEGORY_FINISHED_FILE.

Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE

В следующей таблице содержатся константы, допустимые с этим свойством.

Константа	Описание
WIA_SHOW_PREVIEW_CONTROL	Показать пользователю элемент управления предварительного просмотра, так как это устройство может выполнять предварительный просмотр.
WIA_DONT_SHOW_PREVIEW_CONTROL	Не показывать пользователю элемент управления предварительного просмотра, так как это устройство не может выполнить предварительный просмотр.

WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION
ScannerPictureSupportsChildItemCreation

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

Указывает, может ли приложение (или фильтры) создавать дочерние элементы в текущем элементе.

Необязательно для всех категорий элементов с поддержкой передачи: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM и даже WIA_CATEGORY_FOLDER. (Если хранилище не поддерживает отправку новых элементов, это свойство должно быть либо не поддерживается, либо поддерживаться со значением FALSE .)

Элементы, поддерживающие WIA_IPS_SEGMENTATION и WIA_USE_SEGMENTATION_FILTER, также должны поддерживать WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION и иметь значение TRUE.

Тип: VT_I4, Access: только для чтения, Допустимые значения: TRUE и FALSE

WIA_IPS_THRESHOLD
ScannerPictureThreshold

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

Задает значение в оттенках серого, определяющее, будет ли пиксель преобразован в белый или черный при преобразовании изображения в монохромное. Пиксели, превышающие пороговое значение, становятся белыми. Пиксели ниже порогового значения становятся белыми.

Это свойство требуется для элементов приобретения, которые поддерживают сканирование со значением 1 б/п и для которых свойство WIA_IPA_DATATYPE имеет значение WIA_DATA_THRESHOLD.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_TRANSFER_CAPABILITIES
ScannerPictureTransferCapabilities

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

Указывает, может ли драйвер передавать несколько дочерних элементов в одном вызове передачи.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_FLAG

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

WIA_IPA_UPLOAD_ITEM_SIZE
ScannerPictureInvert

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

Указывает количество байтов, отправляемых для элемента.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_NONE

WIA_IPS_WARM_UP_TIME
ScannerPictureWarmUpTime

Указывает максимальное время прогрева (в миллисекундах), необходимое устройству перед запуском операции сканирования. Мини-диск создает и поддерживает это свойство.

Приложение может прочитать это свойство, чтобы определить максимальное время прогрева для этого устройства. Затем может появиться диалоговое окно "Ожидание прогрева устройства", чтобы сообщить пользователю, что ожидание или пауза могут произойти до того, как что-то произойдет.

Это свойство является обязательным для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

WIA_IPS_XEXTENT
ScannerPictureXextent

Содержит текущую ширину выбранного изображения в пикселях. Приложение задает это свойство, чтобы пометить ширину получаемой области выделения. Это свойство должно соответствовать свойству WIA_IPA_PIXELS_PER_LINE . Мини-диск создает и поддерживает это свойство.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_XPOS
ScannerPictureXpos

Содержит координату x в пикселях верхнего левого угла выбранного изображения. Приложение задает это свойство, чтобы пометить левый верхний угол области выделения. Мини-диск создает и поддерживает это свойство.

Требуется для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_FILM. Он не поддерживается для WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_XRES
ScannerPictureXres

Содержит текущее горизонтальное разрешение устройства (в пикселях на дюйм). Приложение задает это свойство, чтобы задать горизонтальное разрешение. Мини-диск создает и поддерживает это свойство.

Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. Это также случай, когда один параметр разрешения зависит от другого. (Вертикальное разрешение может зависеть от горизонтального разрешения.)

Требуется для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_FILM. Он не поддерживается для WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4, Access: чтение/запись или только чтение, допустимые значения: WIA_PROP_RANGE или WIA_PROP_LIST

WIA_IPS_XSCALING
ScannerPictureXscaling

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

Задает горизонтальное масштабирование в процентах, которое может применяться к отсканированным изображениям на устройстве сканера или в его драйвере.

Это свойство является необязательным для всех элементов с поддержкой приобретения; то есть элементы типов WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK и WIA_CATEGORY_FILM.

Тип: VT_I4, Access: чтение/запись или только чтение, допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE.

Значения могут быть от 1 до максимального VT_I4 (0xFFFF). Например, 100 означает отсутствие масштабирования, 050 означает уменьшение масштаба до 50 % от размера, а 200 означает масштабирование до 200 % от исходного размера.

WIA_IPS_YEXTENT
ScannerPictureYextent

Содержит текущую высоту выбранного изображения в пикселях. Приложение задает это свойство, чтобы пометить высоту области выделения. Это свойство должно быть согласовано со значением свойства WIA_IPA_PIXELS_PER_LINE . Мини-диск создает и поддерживает это свойство.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_YPOS
ScannerPictureYpos

Текущая координата y (в пикселях) левого верхнего угла выбранного изображения. Приложение задает это свойство, чтобы пометить левый верхний угол области выделения. Мини-диск создает и поддерживает это свойство.

Требуется для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_FILM. Он не поддерживается для WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE

WIA_IPS_YRES
ScannerPictureYres

Содержит текущее вертикальное разрешение (в пикселях на дюйм) для устройства. Приложение задает это свойство, чтобы задать вертикальное разрешение. Мини-диск создает и поддерживает это свойство.

Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. Это также случай, когда один параметр разрешения зависит от другого. (Горизонтальное разрешение может зависеть от вертикального разрешения.)

Требуется для всех элементов с поддержкой приобретения; то есть элементы в категориях: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_FILM. Он не поддерживается для WIA_CATEGORY_FOLDER элементов.

Тип: VT_I4, Access: чтение/запись или только чтение, допустимые значения: WIA_PROP_RANGE или WIA_PROP_LIST

WIA_IPS_YSCALING
ScannerPictureYscaling

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

Задает вертикальное масштабирование в процентах, которое может применяться к отсканированным изображениям на устройстве сканера или в его драйвере.

Тип: VT_I4, Access: чтение/запись или только чтение, допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Wiadef.h

Поделиться через

Константы свойств элементов WIA сканера

Требования

Обратная связь

Дополнительные ресурсы