Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Important
Некоторые сведения, содержащиеся в этой статье, относятся к устаревшим операционным системам Windows.
The default class installer for still image devices, sti_ci.dll, recognizes a special set of INF file entries. В INF-файле эти записи должны размещаться в разделе INF DDInstall устройства. Записи описаны в следующей таблице.
| Запись INF-файла | Value | Comments |
|---|---|---|
| SubClass | StillImage | Required |
| DeviceType | 1 для сканеров 2 для камер 3 для потокового видео |
Required |
| DeviceSubType | Vendor-defined value | Optional |
| Connection | Для устройств, отличных от Plug and Play, подключенных к последовательным или параллельным портам, это может быть Serial или Parallel, чтобы ограничить выбор портов пользователя во время установки. | Optional Если он не указан, пользователь может выбрать любой последовательный или параллельный порт. |
| Capabilities | Указывает число, которое преобразуется в битовые флаги, определяющие возможности устройства. Эти флаги хранятся в реестре и доступны для компонентов STI с STI_DEV_CAPS структурой. Bit 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. |
Optional Бит 5 в настоящее время не используется. Задайте для этой записи в INF-файле значение 0x33 для поддержки событий push-button с помощью сканера. |
| PropertyPages | Только для Windows 98 и Windows 2000 Определяет имя и точку входа DLL, которая создает настраиваемые страницы свойств для устройств неподвижных изображений. For more information about the PropertyPages entry, see INF Files for Still Image Devices. |
Optional Эта запись предназначена только для драйверов STI и устарела для драйверов WIA. For information about property pages relevant to WIA driver developers, see the Note on PropertyPages following this table. |
| DeviceData | Identifies a vendor-supplied data section containing information to be stored in the registry, under the DeviceData key. Для устройств, поддерживаемых TWAIN, раздел данных должен содержать запись TwainDS (см. раздел реестра для драйверов WIA) | Optional |
| Events | Определяет предоставленный поставщиком раздел данных, содержащий список событий устройств для неподвижных изображений. Каждая запись в этом разделе должна иметь следующий формат: EventName="String",{GUID},App EventName is the event's internal name, String is the event's display string, GUID is the event's GUID, and App specifies the imaging application to be launched when the event occurs. To launch the currently registered application, use an asterisk () forApp*. |
Required |
| PortSelect | Если установка устройства не требует страницы выбора порта, значение "нет" приводит к пропуску этой страницы. This value also causes the CreateFileName entry value (see the Note on CreateFileName and PortSelect following this table) to be automatically set to AUTO. A value of Message1 causes a system-supplied message to be displayed, and sets the CreateFileName entry value to AUTO. Применяется как к сканерам, так и к камерам, которым требуется ручная установка. |
Optional For Plug and Play devices, PortSelect is ignored, but the device still must have the CreateFileName entry value set to AUTO in order for WIA to load the device. Используйте директиву INF AddReg, чтобы добавить эту запись в раздел INF DDInstall файла INF устройства. |
Note
Чтобы взаимодействовать с устройством, клиент в режиме пользователя (минидрайвер) должен запрашивать у службы WIA имя файла устройства и строку, которая указывает имя объекта, чтобы создать или открыть. (The file name doesn't have to be the name of a disk file.) Responding to such a query, the WIA service obtains the device's file name from the CreateFileName registry entry. (The usbscan.sys and scsiscan.sys kernel-mode drivers create this entry, as does the class installer.) The minidriver receives this file name by calling the IStiDeviceControl::GetMyDevicePortName method. The minidriver can then use this file name when it calls the CreateFile function to open a handle to the device. If the device is installed manually, the class installer creates the CreateFileName entry, setting its value to one that depends on the user's selection on the port selection page: COMX, LPTX, or AUTO. Некоторые устройства (например, сетевые сканеры), установленные вручную, не требуют порта. В таких случаях результирующее диалоговое окно выбора портов может запутать пользователей. Вы можете предотвратить появление этого диалогового окна, добавив следующую запись в раздел INF DDInstall файла INF вашего устройства.
PortSelect=NO
Note
A side effect of this entry value is that the CreateFileName entry is set to AUTO. Примите к сведению, что если минидрайвер получает AUTO для имени файла, он должен иметь возможность самостоятельно определить, с каким устройством ему следует взаимодействовать.
Note
Для PropertyPages драйвер WIA должен использовать другой механизм расширяемости, чтобы добавить страницы свойств. Он также должен добавить собственный GUID в запись идентификатора класса пользовательского интерфейса в своих INF-файлах и предоставить конкретную регистрацию расширяемости пользовательского интерфейса (см. записи реестра расширяемости пользовательского интерфейса) для заменяемых компонентов пользовательского интерфейса, таких как общие диалоги, или добавляемых, таких как контекстные меню и страницы свойств. Драйвер WIA также должен предоставить регистрацию расширяемости пользовательского интерфейса для самого компонента.
Другие записи INF-файла
Записи в следующей таблице должны быть помещены в раздел, на который указывает директива INF AddReg устройства:
| Запись INF-файла | Value | Comments |
|---|---|---|
| HardwareConfig | Указывает тип подключения, используемого устройством. 1,1 — универсальное устройство WDM 1,2 — устройство SCSI 1,4 – USB-устройство 1,8 — последовательное устройство 1,16 — параллельное устройство |
Optional |
| USDClass | Указывает GUID для минидрайвера. | Optional. The GUID in the USDClass and CLSID entries must match the GUID that is used in the DllGetClassObject function of the minidriver. Если вы пишете микродрайвер, значение должно быть BB6CF8E2-1511-40bd-91BA-80D43C53064E. Otherwise, you must generate a new GUID, using, for example, genguid.exe. |
| CLSID | Указывает GUID для минидрайвера. | Optional. See the immediately preceding comments for the USDClass entry. |
Установщик классов по умолчанию для устройств статических изображений поддерживает стандарт директиву INF CopyFiles.
The default INF file for still image devices, sti.inf, defines two installation sections for each device type, as follows:
Раздел INF DDInstall, на который необходимо ссылаться в разделе DDInstall предоставленного поставщиком INF-файла, как показано в следующей таблице.
Device Type Include Needs IEEE 1394/SBP2 Include=sti.inf Needs=STI.SBP2Section USB Include=sti.inf Needs=STI.USBSection SCSI Include=sti.inf Needs=STI.SCSISection Serial Include=sti.inf Needs=STI.SerialSection Раздел INF DDInstall Services, на который необходимо ссылаться в разделе INF DDInstall.Services предоставленного поставщиком INF-файла, как показано в следующей таблице.
Device Type Include Needs 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 Serial Include=sti.inf Needs=STI.SerialSection.Services
Вы можете изучить любой INF-файл, предоставленный Windows, содержащий запись SubClass=StillImage, для получения более подробных рекомендаций по созданию INF-файлов для устройств фиксированных изображений.
To designate the device as a WIA device, the minidriver INF file must contain the following values placed within the DeviceData section of the vendor-supplied INF file.
| Запись в INF-файл | Value | Comments |
|---|---|---|
| Server | Local | Указывает устройство как локальное устройство. Это необязательно; если поставщик не указывает значение записи, устройство считается локальным. То есть свойство WIA_DIP_SERVER_NAME имеет значение Local. |
| MicroDriver | Vendor-supplied .dll file name | Эта запись должна быть задана в качестве имени предоставленной поставщиком библиотеки DLL, реализующей микродрайвер WIA. |
| UI DLL | Vendor-supplied .dll file name | Устаревшие и никогда не используемые. Ранее эта запись указала имя предоставленного поставщиком DLL-файла пользовательского интерфейса. |
| Идентификатор класса пользовательского интерфейса | Идентификатор класса устройства, предоставленный поставщиком | Указывает класс устройства, который пользовательский интерфейс, предоставленный поставщиком, способен поддерживать. Это необязательно, и если поставщик не указывает значение записи, WIA задает для свойства WIA_DIP_UI_CLSID значение GUID_NULL, и используется стандартный интерфейс WIA. |
| ICMProfiles | Предоставленное поставщиком значение профиля цвета | Указывает значение, которое нужно поместить в свойство WIA_IPA_ICM_PROFILE_NAME. Если значение не указано, используется стандартный профиль профиль цветового пространства sRGB.icm. |
The MicroDriver entry is required only if the vendor supplies a WIA microdriver.
Записи пользовательского интерфейса требуются только в том случае, если поставщик предоставляет пользовательский интерфейс для устройства для обработки изображений.
Remarks
При разработке INF-файла для сканеров можно использовать дескрипторы ОС Майкрософт для включения функций идентификатора совместимости. При этом можно разрешить одному драйверу сканера быть совместимым с несколькими моделями сканера.