INF-файлы для устройств WIA

Важно!

Некоторые сведения, содержащиеся в этой статье, относятся к устаревшим операционным системам Windows.

Установщик класса по умолчанию для устройств с изображениями ,sti_ci.dll, распознает специальный набор записей INF-файла. В INF-файле эти записи должны быть помещены в раздел INF DDInstall устройства. Записи описаны в следующей таблице.

Запись INF-файла	Значение	Комментарии
Подкласс	StillImage	Обязательно
DeviceType	1 для сканеров 2 для камер 3 для потоковой передачи видео	Обязательно
DeviceSubType	Определенное поставщиком значение	Необязательно
Соединение	Для устройств без Plug and Play, подключенных к последовательным или параллельным портам, это может быть последовательный или параллельный, чтобы ограничить выбор портов пользователем во время установки.	Необязательно Если не указано, пользователь может выбрать любой последовательный или параллельный порт.
Capabilities	Указывает число, которое преобразуется в битовые флаги, определяющие возможности устройства. Эти флаги хранятся в реестре и доступны для компонентов STI с помощью структуры STI_DEV_CAPS. Бит 0 — задает или очищает STI_GENCAP_NOTIFICATIONS в STI_DEV_CAPS. Бит 1 — задает или очищает STI_GENCAP_POLLING_NEEDED в STI_DEV_CAPS. Бит 2 — задает или очищает STI_GENCAP_GENERATE_ARRIVALEVENT в STI_DEV_CAPS. Бит 3 — задает или очищает STI_GENCAP_AUTO_PORTSELECT в STI_DEV_CAPS. Бит 4 — задает или очищает STI_GENCAP_WIA в STI_DEV_CAPS. Бит 5 — задает или очищает STI_GENCAP_SUBSET в STI_DEV_CAPS.	Необязательно Бит 5 в настоящее время не используется. Задайте для этой записи в INF-файле 0x33 для поддержки событий нажатия кнопки в сканере.
Страницы свойств	Только для Windows 98 и Windows 2000 Идентифицирует имя и точку входа библиотеки DLL, которая создает настраиваемые страницы страниц свойств для устройств с неподвижными изображениями. Дополнительные сведения о записи PropertyPages см. в разделе Inf Files for Still Image Devices.	Необязательно Эта запись предназначена только для драйверов STI и устарела для драйверов WIA. Сведения о страницах свойств, относящихся к разработчикам драйверов WIA, см. в примечании к PropertyPages после этой таблицы.
DeviceData	Определяет предоставленный поставщиком раздел данных, содержащий сведения, которые будут храниться в реестре в разделе DeviceData . Для устройств, поддерживаемых TWAIN, раздел данных должен содержать запись TwainDS (см. раздел Записи реестра для драйверов WIA).	Необязательно
События	Идентифицирует предоставленный поставщиком раздел данных, в котором по-прежнему содержится изображение событий устройства. Каждая запись в этом разделе должна иметь следующий формат: EventName="String",{GUID},App EventName — это внутреннее имя события, String — отображаемая строка события, GUID — GUID события, а App указывает приложение для создания образов, которое будет запущено при возникновении события. Чтобы запустить зарегистрированное приложение, используйте звездочку () дляприложения*.	Обязательно
PortSelect	Если для установки устройства не требуется страница выбора порта, значение "нет" приводит к пропуску этой страницы. Это значение также приводит к тому, что значение записи CreateFileName (см. примечание о CreateFileName и PortSelect после этой таблицы) будет автоматически задано значение AUTO. Значение Message1 приводит к отображению предоставленного системой сообщения и задает для записи CreateFileName значение AUTO. Применяется как к сканерам, так и к камерам, для которых требуется установка вручную.	Необязательно Обратите внимание, что для Plug and Play устройств параметр PortSelect игнорируется, но для устройства по-прежнему должно быть задано значение AUTO, чтобы WIA загрузил устройство. Используйте директиву INF AddReg , чтобы добавить эту запись в раздел INF DDInstall INF-файла устройства.

Примечание

Для взаимодействия с устройством клиент пользовательского режима (мини-диск) должен запросить у службы WIA имя файла устройства и строку, указывающую имя создаваемого или открытого объекта. (Имя файла не обязательно должно быть именем файла диска.) Отвечая на такой запрос, служба WIA получает имя файла устройства из записи реестра CreateFileName . ( Драйверыusbscan.sys и scsiscan.sys режима ядра создают эту запись, как и установщик класса.) Мини-driver получает это имя файла путем вызова метода IStiDeviceControl::GetMyDevicePortName . Затем мини-диск может использовать это имя файла при вызове функции CreateFile , чтобы открыть дескриптор устройства. Если устройство установлено вручную, установщик класса создает запись CreateFileName , задав для нее значение, которое зависит от выбора пользователем на странице выбора порта: COMX, LPTX или AUTO. Для некоторых устройств (например, сканеров сети), установленных вручную, порт не требуется. В таких случаях результирующее диалоговое окно выбора порта может сбить пользователей с толку. Чтобы предотвратить появление этого диалогового окна, добавьте следующую запись в раздел INF DDInstall INF-файла устройства.

PortSelect=NO

Примечание

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

Примечание

Для PropertyPages драйвер WIA должен использовать другой механизм расширяемости для добавления страниц свойств. Он также должен добавить собственный GUID к записи идентификатора класса пользовательского интерфейса в INF-файлах и предоставить определенную регистрацию расширяемости пользовательского интерфейса (см. раздел Записи реестра расширений пользовательского интерфейса) для заменяемых компонентов пользовательского интерфейса, таких как общие диалоговые окна, или добавленных, таких как контекстные меню и страницы свойств. Драйвер WIA также должен предоставлять регистрацию расширяемости пользовательского интерфейса для самого компонента.

Дополнительные записи INF-файла

Записи в следующей таблице должны быть помещены в раздел, на который указывает директива INF AddReg устройства:

Запись INF-файла	Значение	Комментарии
HardwareConfig	Указывает тип подключения, используемого устройством. 1,1 — универсальное устройство WDM 1,2 − устройство SCSI 1,4 − USB-устройство 1,8 − последовательное устройство 1,16 − параллельное устройство	Необязательно
КЛАСС USD	Указывает GUID для мини-драйвера.	Необязательный элемент. Идентификатор GUID в записях USDClass и CLSID должен соответствовать идентификатору GUID, который используется в функции DllGetClassObject мини-драйвера. Если вы пишете microdriver, значение должно быть BB6CF8E2-1511-40bd-91BA-80D43C53064E. В противном случае необходимо создать новый GUID, используя, например, genguid.exe.
CLSID	Указывает GUID для мини-накопителя.	Необязательный элемент. Ознакомьтесь с приведенными выше комментариями для записи USDClass .

Установщик классов по умолчанию для устройств с неподвижными образами поддерживает стандартную директиву INF CopyFiles.

Inf-файл по умолчанию для устройств с неподвижным образом sti.inf определяет два раздела установки для каждого типа устройства следующим образом:

• Раздел INF DDInstall, на который необходимо ссылаться в разделе DDInstall предоставленного поставщиком INF-файла, как показано в следующей таблице.

  Тип устройства	Включение	Потребности
  IEEE 1394/SBP2	Include=sti.inf	Needs=STI. SBP2Section
  USB	Include=sti.inf	Needs=STI. USBSection
  SCSI	Include=sti.inf	Needs=STI. SCSISection
  Серийный номер	Include=sti.inf	Needs=STI. SerialSection

• Раздел INF DDInstall Services, на который необходимо ссылаться в разделе INF DDInstall.Services предоставленного поставщиком INF-файла, как показано в следующей таблице.

  Тип устройства	Включение	Потребности
  1394/SBP2	Include=sti.inf	Needs=STI. SBP2Section.Services
  USB	Include=sti.inf	Needs=STI. USBSection.Services
  SCSI	Include=sti.inf	Needs=STI. SCSISection.Services
  Серийный номер	Include=sti.inf	Needs=STI. SerialSection.Services

Дополнительные инструкции по созданию INF-файлов для устройств с неподвижными образами см. в любом INF-файле, предоставленном в Windows, который содержит запись SubClass=StillImage.

Чтобы назначить устройство WIA, INF-файл мини-накопителя должен содержать следующие значения, помещенные в раздел DeviceData INF-файла, предоставленного поставщиком.

Запись INF-файла	Значение	Комментарии
Сервер	Local	Обозначает устройство как локальное. Это необязательное действие, и если поставщик не указывает значение записи, предполагается, что устройство является локальным. То есть для свойства WIA_DIP_SERVER_NAME задано значение Local.
MicroDriver	Имя файла .dll , предоставленное поставщиком	Для этой записи должно быть задано имя предоставленной поставщиком библиотеки DLL, реализующей микродрайвер WIA.
БИБЛИОТЕКА DLL пользовательского интерфейса	Имя файла .dll , предоставленное поставщиком	Устарел и никогда не используется. Раньше эта запись указывала имя предоставленного поставщиком DLL-файла пользовательского интерфейса.
Идентификатор класса пользовательского интерфейса	Предоставленный поставщиком идентификатор класса устройства	Указывает класс устройства, поддерживаемый предоставляемым поставщиком пользовательским интерфейсом. Это необязательно, и если поставщик не указывает значение записи, WIA устанавливает для свойства WIA_DIP_UI_CLSID значение GUID_NULL и используется пользовательский интерфейс WIA по умолчанию.
ICMProfiles	Значение цветового профиля, предоставленное поставщиком	Задает значение, помещаемое в свойство WIA_IPA_ICM_PROFILE_NAME. Если значение не указано, используется стандартный профиль sRGB sRGB Color Space Profile.icm .

Запись MicroDriver требуется только в том случае, если поставщик поставляет микроdriver WIA.

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

Комментарии

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