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


INF-файлы для устройств с изображением по-прежнему

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 Для устройств, отличных от PnP, подключенных к последовательным или параллельным портам, это может быть последовательный или параллельный, чтобы ограничить выбор портов пользователя во время установки. Optional.
Если он не указан, пользователь может выбрать любой последовательный или параллельный порт.
Capabilities Указывает число, которое преобразуется в битовые флаги, определяющие возможности устройства. These flags are stored in the registry and are available to Microsoft STI components with the STI_DEV_CAPS structure.

Bit 0 — задает и очищает STI_GENCAP_NOTIFICATIONS в STI_DEV_CAPS
Бит 1 — задает и очищает STI_GENCAP_POLLING_NEEDED в STI_DEV_CAPS
Bit 2 — наборы и очистки STI_GENCAP_GENERATE_ARRIVALEVENT в STI_DEV_CAPS
Бит 3 — наборы и очистки STI_GENCAP_AUTO_PORTSELECT в STI_DEV_CAPS
Optional
PropertyPages Определяет имя и точку входа библиотеки DLL, которая создает настраиваемые страницы листов свойств для устройств по-прежнему изображения.
The following example identifies the DLL, estp2cpl.dll, and the EnumStiPropPages entry point in this DLL. The entry point name is optional; if omitted, the entry point defaults to EnumStiPropPages.

PropertyPages = estp2cpl.dll, EnumStiPropPages

Optional
DeviceData Identifies a vendor-supplied data section containing information to be stored in the registry, under the DeviceData key. For TWAIN-supported devices, the data section must contain a TwainDS entry. Дополнительные сведения см. в разделе "Значения реестра, изменяемые поставщиком" Optional.
Однако эта запись требуется для создания Push-Model приложений с поддержкой поддержки.
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, see Still Image Device Events, and App specifies the imaging application to be launched when the event occurs. To launch the currently registered application, use an asterisk (*) for App.
Optional.
Однако эта запись требуется для создания Push-Model приложений с поддержкой поддержки.
UninstallSection Указывает на раздел INF, который обычно содержит директивы INF DelFiles и директивы INF DelReg. Запись в этом разделе имеет следующий формат:

UninstallSection=UninstallSectionName

UninstallSectionName is the name of the section containing Delfiles or DelReg directives. Защита файлов Windows может запретить пользователю удалять некоторые файлы, даже если они указаны с помощью директив DelFiles .
Optional.
Эта запись действительна только для Windows 2000.

Установщик классов по умолчанию для устройств с изображением по-прежнему поддерживает стандартную директиву 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-файла, как показано в следующей таблице.

    USB devices SCSI devices Serial devices
    Include=sti.inf

    Needs=STI.USBSection
    Include=sti.inf

    Needs=STI.SCSISection
    Include=sti.inf

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

    USB devices SCSI devices Serial devices
    Include=sti.inf

    Needs=STI.USBSection.Services
    Include=sti.inf

    Needs=STI.SCSISection.Services
    Include=sti.inf

    Needs=STI.SerialSection.Services

Если вы также создаете компоненты, относящиеся к устройству для API получения изображений, обычно в inf-файле будут включены имена файлов для этих компонентов.

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

Remarks

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