静态图像设备的 INF 文件

  • 项目

静态映像设备的默认类安装程序 sti_ci.dll，可识别一组特殊的 INF 文件条目。 在 INF 文件中，这些条目必须放置在设备的 INF DDInstall 节中。 下表介绍了这些条目。

INF 文件条目 值 注释
子类 StillImage 必需
DeviceType 1 个用于扫描仪，2 个用于相机，3 个用于视频设备 必需
DeviceSubType 供应商定义的值 可选
连接 对于连接到串行或并行端口的非 PnP 设备，这可以是串行或并行，以限制用户在安装期间选择的端口。 可选。
如果未指定，用户可以选择任何串行或并行端口。
功能 指定一个数字，该数字转换为标识设备功能的位标志。 这些标志存储在注册表中，可用于具有 STI_DEV_CAPS 结构的 Microsoft STI 组件。

位 0 • 设置/清除 STI_DEV_CAPS 中的STI_GENCAP_NOTIFICATIONS
位 1 • 在 STI_DEV_CAPS 中设置/清除STI_GENCAP_POLLING_NEEDED
位 2 • 设置/清除 STI_DEV_CAPS 中的STI_GENCAP_GENERATE_ARRIVALEVENT
位 3 • 在 STI_DEV_CAPS 中设置/清除STI_GENCAP_AUTO_PORTSELECT		 可选
PropertyPages 标识 为静态图像设备创建自定义属性表页的 DLL 的名称和入口点。
以下示例标识此 DLL 中的 DLLestp2cpl.dll和 EnumStiPropPages 入口点。 入口点名称是可选的;如果省略，则入口点默认为 EnumStiPropPages。

PropertyPages = estp2cpl.dll, EnumStiPropPages

 可选
DeviceData 标识供应商提供的数据部分，其中包含要存储在 注册表中的 DeviceData 键下的信息。 对于支持 TWAIN 的设备，数据部分必须包含 TwainDS 条目。 有关详细信息，请参阅 供应商可修改注册表值 可选。
但是，创建 Push-Model 感知应用程序需要此条目。
事件 标识供应商提供的数据部分，其中列出了静止图像设备事件。 本部分中的每个条目必须采用以下格式：

EventName="String",{GUID},App

EventName 是事件的内部名称，String 是事件的显示字符串，GUID 是事件的 GUID，请参阅静态图像设备事件，应用指定要在事件发生时启动的映像应用程序。 若要启动当前注册的应用程序，请使用适用于 App 的星号 (*) 。		 可选。
但是，创建 Push-Model 感知应用程序需要此条目。
UninstallSection 指向通常包含 INF DelFiles 指令 和 INF DelReg 指令的 INF 节。 本部分中的条目采用以下格式：

UninstallSection=UninstallSectionName

UninstallSectionName 是包含 Delfiles 或 DelReg 指令的节的名称。 Windows 文件保护 可能会禁止用户删除某些文件，即使这些文件是使用 DelFiles 指令指定的。		 可选。
此项仅适用于 Windows 2000。

静态映像设备的默认类安装程序支持标准 INF CopyFiles 指令。 安装程序对组件文件使用内部引用计数器，因此在卸载操作期间不会过早删除多个设备共享的文件。

静态映像设备的默认 INF 文件 sti.inf 为每个设备类型定义两个安装部分，如下所示：

  • INF DDInstall 节，必须在供应商提供的 INF 文件的 DDInstall 节中引用，如下表所示。

    USB 设备 SCSI 设备 串行设备
    Include=sti.inf

    Needs=STI.USBSection    		 Include=sti.inf

    Needs=STI.SCSISection    		 Include=sti.inf

    Needs=STI.SerialSection

  • INF DDInstall.Services 节，必须在 DDInstall 中引用它。供应商提供的 INF 文件的“服务”部分，如下表所示。

    USB 设备 SCSI 设备 串行设备
    Include=sti.inf

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

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

    Needs=STI.SerialSection.Services

如果还要 为映像获取 API 创建特定于设备的组件，通常会在 INF 文件中包括这些组件的文件名。

有关为静态图像设备创建 INF 文件的其他指导，可以查看 Windows 提供的包含条目“Subclass=StillImage”的任何 INF 文件。

注解

为扫描程序开发 INF 文件时，可以使用 Microsoft OS 描述符 来启用兼容性 ID 功能。 执行此操作时，允许一个扫描程序驱动程序与多个扫描程序模型兼容。