Общие константы свойств элемента WIA
Следующие константы свойств устройства должны поддерживаться всеми интерфейсами интерфейса IWiaItem, IWiaItem2 и IWiaDrvItem , если иное не указано в их описаниях.
Префикс "WIA_IPA_" указывает на свойство элемента для всех устройств и является соглашением об именовании, используемым в C/C++. Для создания скриптов эти константы используют префикс Picture и являются частью перечисленного типа WiaItemPropertyId . Соответствующее имя члена из перечисления скрипта отображается в круглых скобках рядом с именем константы C/C++ в следующем списке.
| Констант/значение | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Этот флаг управляет доступом к элементу, а также указывает, удаляется ли элемент. Требуется для всех элементов WIA 2.0. Тип: VT_I4; Чтение и запись или только чтение в зависимости от возможности изменения прав доступа элемента; Допустимые значения: WIA_PROP_FLAG В следующей таблице содержатся пять флагов, допустимых с этим свойством.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство зарезервировано для использования в будущем и в настоящее время не реализовано. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит число битов на канал для образа. Мини-driver создает и поддерживает это свойство. Требуется для всех элементов образов с поддержкой приобретения WIA 2.0 или сохраненных образов. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит размер буфера (в байтах), используемый во время передачи данных. Мини-driver создает и поддерживает это свойство. Приложение может считывать это свойство, чтобы определить размер буфера, заданный драйвером для передачи данных. Служба WIA также считывает это свойство для выделения памяти для мини-накопителя во время передачи данных Необязательно для всех элементов WIA 2.0 с поддержкой передачи. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE
Примечание. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит количество байтов в одной строке сканирования изображения. Мини-driver создает и поддерживает это свойство. Необязательно для всех элементов WIA 2.0. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит количество каналов на пиксель для изображения. Мини-driver создает и поддерживает это свойство. Требуется для всех элементов образов с поддержкой приобретения WIA 2.0 или сохраненных образов. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство зарезервировано для использования в будущем и в настоящее время не реализовано. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит текущий используемый тип сжатия. Мини-driver создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить тип сжатия изображения, или задает это свойство для настройки параметра сжатия. Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST В следующей таблице содержатся константы, допустимые с этим свойством. Символ V указывает, что константная поддерживается только в Windows Vista и более поздних версиях. (Он доступен только через интерфейс IWiaItem2 .)
[!Примечание] Если это свойство WIA_COMPRESSION_NONE, а WIA_IPA_FORMAT — WiaImgFmt_PDFA или WiaImgFmt_XPS; тогда WIA_COMPRESSION_NONE означает, что режим сжатия не определен, и сканер должен выбрать режим. WIA_COMPRESSION_AUTO — это новое значение свойства, определенное для свойства WIA_IPA_COMPRESSION. Это значение допустимо для всех программируемых элементов источника данных изображения, включая Flatbed и Feeder. Если это значение поддерживается мини-драйвером WIA, клиент приложения WIA может задать WIA_IPA_COMPRESSION, чтобы включить автоматическое обнаружение режима сжатия на устройстве. WIA_COMPRESSION_AUTO могут работать с поддержкой и без поддержки или включения полного автоматического цвета (WIA_DATA_AUTO и WIA_DEPTH_AUTO). WIA_COMPRESSION_AUTO наиболее удобно использовать в форматах файлов передачи, которые поддерживают несколько типов данных и битовую глубину, например WiaImgFmt_RAW. Дополнительные сведения о форматах файлов передачи см. в разделе WIA_IPA_FORMAT в этой таблице. Это opitonal для WIA мини-водитель, чтобы suport WIA_COMPRESSION_AUTO. При его поддержке мини-драйвер WIA никогда не должен устанавливать его в качестве значения по умолчанию для WIA_IPA_COMPRESSION; Это значение может задать только приложение WIA. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит текущий параметр типа данных для устройства. Мини-диск создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить тип данных изображения. Приложение записывает это свойство, чтобы задать текущий тип данных изображения, которое будет передано. Это свойство является обязательным для всех элементов WIA 2.0. Для всех элементов с поддержкой приобретения WIA 2.0 это должно быть чтение и запись, а для элементов хранилища WIA 2.0 — только чтение. Тип: VT_I4; Доступ для операционных систем, предшествующих Windows Vista: это свойство доступно только для чтения для камер и чтение и запись для сканеров; Access для Windows Vista и более поздних версий: это свойство доступно только для чтения для WIA_CATEGORY_FOLDER и WIA_CATEGORY_FINISHED_FILE элементов, а для всех остальных категорий элементов WIA 2.0 — чтение и запись; Допустимые значения: WIA_PROP_LIST В следующей таблице содержится шесть констант, допустимых с , если для WIA_IPA_FORMAT не задано значение WiaImgFmt_RAW.
Свойство WIA_IPA_DATATYPE также используется для описания типа передачи необработанных данных, используемых, когда приложение задает WiaImgFmt_RAW. Драйвер должен задать для свойства WIA_IPA_DATATYPE список допустимых значений, из которых приложение может выбрать одно из них. Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. Проверьте свойство WIA_IPA_DEPTH , чтобы определить битовую глубину. Это свойство обычно содержит одно значение для камер. В следующей таблице перечислены константы, допустимые с WIA_IPA_DATATYPE , если для WIA_IPA_FORMAT задано значение WiaImgFmt_RAW.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH Содержит параметр битовой глубины изображения. Мини-диск создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить битовую глубину изображения. Приложение также может задать для этого значения нужную битовую глубину. Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. Это свойство является обязательным для всех элементов WIA 2.0. Для всех элементов с поддержкой приобретения WIA 2.0 это должно быть чтение и запись, а для элементов хранилища WIA 2.0 — только чтение. Тип: VT_I4; Доступ для операционных систем до Windows Vista: чтение и запись; Access для Windows Vista и более поздних версий: это свойство доступно только для чтения для WIA_CATEGORY_FOLDER и WIA_CATEGORY_FINISHED_FILE элементов, а для всех остальных категорий элементов WIA 2.0 — чтение и запись; Допустимые значения: WIA_PROP_LIST WIA_DEPTH_AUTO определяется как 0 бит на пиксель, и это новое значение свойства, определенное для WIA_IPA_DEPTH. Это значение допустимо для всех программируемых элементов источника данных изображения, включая Flatbed и Feeder. Если WIA_DEPTH_AUTO поддерживается мини-драйвером WIA, клиент приложения WIA может задать для WIA_IPA_DEPTH это значение, чтобы включить автоматическое обнаружение цвета на устройстве. Если задано WIA_DEPTH_AUTO, мини-драйвер WIA должен обновить WIA_IPA_DATATYPE на том же элементе до WIA_DATA_AUTO (которое должно быть поддерживаемым значением, если устройство поддерживает автоматический цвет). WIA_DEPTH_AUTO является необязательным значением, но оно становится обязательным, если WIA_DATA_AUTO поддерживается для WIA_IPA_DATATYPE. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит расширение имени файла для определенного формата файла. Мини-диск создает и поддерживает это свойство. Необязательно для всех элементов WIA 2.0 с поддержкой передачи. Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE Драйвер обновляет это свойство, чтобы отразить текущее значение свойства WIA_IPA_FORMAT . Например, если WIA_IPA_FORMAT WiaImgFmt_JPEG, WIA_IPA_FILENAME_EXTENSION должно быть jpg. Если WIA_IPA_FORMAT WiaImgFmt_BMP, WIA_IPA_FILENAME_EXTENSION должен быть BMP.
Примечание. Это свойство рекомендуется для драйверов, поддерживающих стандартные форматы, и является обязательным для драйверов, реализующих пользовательские форматы. Он сообщает приложению о правильном расширении имени файла для использования во время передачи файлов в частном формате. Например, если корпорация A. Datum создала драйвер WIA, который передал файл в новом формате, компания может указать расширение "adc". Это позволяет приложениям передавать данные в этом формате в файл и создавать имя файла, например myfile.adc, что полезно для других пользователей, которые понимают новое расширение. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит текущий формат изображения, который должен быть передан. Приложение считывает это свойство, чтобы определить формат изображения, которое оно будет получать. Приложение записывает это свойство, чтобы задать формат. Это свойство зависит от свойства WIA_IPA_TYMED . Мини-диск создает и поддерживает это свойство. Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. Тип: CLSID, Access: чтение и запись, допустимые значения: WIA_PROP_LIST В следующей таблице перечислены константы, допустимые для этого свойства. Звездочка * указывает, что константа не поддерживается в Windows Vista. (Он доступен только через интерфейс IWiaItem .) Двойная звездочка ** указывает, что константы не поддерживаются ни в Windows Server 2003, ни в Windows Vista. Символ V указывает, что константы поддерживаются только в Windows Vista и более поздних версиях. (Он доступен только через интерфейс IWiaItem2 .)
Примечание. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит полное имя элемента (имя элемента вместе со сведениями о пути). Полное имя элемента совпадает с параметром bstrFullItemName служебной функции wiasCreateDrvItem . Приложение считывает это свойство, чтобы определить, какой элемент используется в данный момент и где этот элемент находится в дереве элементов. Каждый элемент должен иметь уникальное имя. Приложения обычно используют полное имя элемента для поиска элементов в дереве элементов. Служба WIA создает и поддерживает это свойство. Требуется для всех элементов WIA 2.0. Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство зарезервировано для использования в будущем и в настоящее время не реализовано. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит имя профиля ICM, необходимое для правильного декодирования изображения. Приложение считывает это свойство, чтобы определить профиль ICM, используемый при обработке изображения. Служба WIA создает и поддерживает это свойство на основе записи ICMProfiles в файле установки драйвера. Тип: VT_BSTR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Поддерживается только в Windows Vista и более поздних версиях. Элементы WIA 2.0 группируются в категории, определяющие способ обработки или использования IWiaItem2 . Например, если элемент представляет подающее средство, приложение должно ожидать, что он будет содержать необходимые свойства средства подачи документов и работать как средство подачи документов. Если элемент представляет готовый файл, приложение WIA 2.0 должно обрабатывать его таким образом, предполагая, что данные являются статическими и расположены на устройстве. (Правила для каждого элемента будут определены в отдельных документах спецификации.) Требуется для всех элементов WIA 2.0. Тип: VT_CLSID, Access: только для чтения, Допустимые значения: GUID категории элементов |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит описательные флаги для элемента WIA. Флаги элементов совпадают с флагами в параметре lObjectFlags служебной функции службы wiasCreateDrvItem . Служба WIA создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить значения описательного флага элемента. Тип: VT_I4 Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице приведены флаги, допустимые для этого свойства. Звездочка * указывает, что флаг не поддерживается в Windows Vista и более поздних версиях. (Он доступен только через интерфейс IWiaItem .) Двойная звездочка ** указывает, что флаг не поддерживается ни в Windows Server 2003, ни в Windows Vista, ни в более поздних версиях. Символ V указывает, что флаг поддерживается только в Windows Vista и более поздних версиях. (Он доступен только через интерфейс IWiaItem2 .)
Некоторые из этих флагов являются обязательными или необязательными для элементов WIA 2.0 в соответствии с категорией элемента, как показано в этой таблице.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит имя элемента. Приложение считывает это свойство, чтобы определить, какой элемент используется в данный момент. Каждый элемент имеет уникальное имя. Служба WIA создает и поддерживает это свойство. Требуется для всех элементов WIA 2.0. Тип: VT_BSTR, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит текущий размер (в байтах) данных, связанных с элементом. Мини-driver создает и поддерживает это свойство. Содержит — это общий размер передаваемых данных. Если это значение равно нулю, это означает, что мини-диск не имеет сведений о точном размере данных. (Это распространено для сжатых данных.) Приложение считывает это значение, чтобы определить размер приобретения перед его выполнением. Служба WIA считывает это свойство, чтобы помочь в выделении памяти для передачи данных. Дополнительные сведения см. в разделе Передача данных в приложение WIA , если свойство имеет нулевое значение и TYMED настроено для передачи файлов, служба WIA не выделяет память для мини-накопителя WIA. Требуется для всех элементов WIA 2.0 с поддержкой передачи. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит время первоначального захвата изображения. Мини-driver создает и поддерживает это свойство. Это свойство должно быть указано в виде вектора из восьми значений WORD в виде структуры SYSTEMTIME (описано в документации по пакету SDK для платформы). Необязательно для всех элементов WIA 2.0. Тип: VT_UI2 | VT_VECTOR Доступ: только для чтения и записи или только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Поддерживается только в Windows Vista и более поздних версиях. Указывает, сколько элементов хранится в элементе WIA_CATEGORY_FOLDER. Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Указывает минимальный размер буфера, используемый при передаче данных. Если передача данных выполняется с помощью механизма обратного вызова, значение свойства может быть не более 64 КБ. Однако если передача выполняется в файл, значение свойства — это количество байтов, необходимых для передачи одной страницы данных за раз. Мини-диск создает и поддерживает это свойство WIA. Необязательно для всех элементов WIA 2.0 с поддержкой передачи. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит количество строк, содержащихся на изображении (вертикальная высота изображения в пикселях). Мини-driver создает и поддерживает это свойство. Необязательно для всех элементов WIA 2.0. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит количество пикселей в каждой строке изображения (ширина изображения в пикселях). Мини-driver создает и поддерживает это свойство. Необязательно для всех элементов WIA 2.0. Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство не поддерживается в Windows Vista и более поздних версий. Содержит параметры упаковки данных изображений. Мини-driver создает и поддерживает это свойство. Приложение считывает это свойство для определения параметров упаковки изображений или задает текущие параметры упаковки изображений. Тип: VT_I4; Доступ: чтение и запись; Допустимые значения: WIA_PROP_LIST. Если для устройства можно задать только одно значение, создайте тип WIA_PROP_LIST и поместите в него допустимое значение. В следующей таблице приведены две константы, допустимые для этого свойства.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Содержит предпочтительный формат для изображений, которые передает этот мини-диск. Мини-диск создает и поддерживает это свойство. Требуется для всех элементов WIA 2.0 с поддержкой передачи. Тип: CLSID, Access: только для чтения, допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Задает ИДЕНТИФИКАТОР CLSID, представляющий набор значений свойств устройства. Если драйвер устройства реализует эту функцию, приложения используют это свойство, чтобы определить, поддерживает ли устройство набор значений. Тип: CLSID, Access: только для чтения, Допустимые значения: WIA_PROP_LIST В следующей таблице содержится 12 констант, допустимых с этим свойством.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Поддерживается только в Windows Vista и более поздних версиях. Содержит количество битов в каждом канале. Это свойство должно быть представлено как вектор с таким количеством значений BYTE, сколько существует каналов, где первый BYTE соответствует количеству битов в первом канале, второй байт — количеству битов во втором канале и т. д. В соответствии с WIA_IPA_CHANNELS_PER_PIXEL должно быть столько записей, сколько каналов. Драйвер задает это свойство, когда приложение переключается на WiaImgFmt_RAW. Для известных подтипов существует столько записей, сколько указано в таблице в разделе WIA_IPA_RAW_SUBTYPE. Тип: VT_UI1|VT_VECTOR, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство зарезервировано для использования в будущем и в настоящее время не реализовано. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Указывает, следует ли подавлять общие страницы свойств для элементов на устройстве. Это свойство доступно в Windows XP и более поздних версиях. Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE В следующей таблице содержатся константы, допустимые для этого свойства. Звездочка * указывает, что константа недопустима в Windows Vista и более поздних версиях. (Он доступен только через интерфейс IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Это свойство содержит параметр метода передачи. Мини-диск создает и поддерживает это свойство. Приложение считывает это свойство, чтобы определить метод передачи данных в мини-накопителе. Требуется для всех элементов WIA 2.0 с поддержкой передачи. Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST В следующей таблице содержатся константы, допустимые для этого свойства. Звездочка * указывает на константы, недопустимые в Windows Vista и более поздних версиях. (Они доступны только через интерфейс IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Поддерживается только в Windows Vista и более поздних версиях. Указывает количество байтов для отправки элемента. Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_NONE |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|