安装自定义的驱动程序组件

重要

新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。

有关详细信息,请参阅新式打印平台打印支持应用设计指南

为 Microsoft 的打印机驱动程序提供自定义组件时,还必须提供一个 .ini 文件来安装该组件。 (如果你的打印机不受 ntprint.inf 支持,还必须提供打印机 INF 文件。)

.ini 文件必须包含 OEMFiles 节。 在本节中,每个自定义组件都使用以下条目之一进行描述:

  • OEMDriverFilen

    为渲染插件命名。

  • OEMConfigFilen

    为用户界面插件命名。

其中 n 指定安装程序安装文件的顺序。 对于这两种类型的插件,为 n 指定的数字必须是连续的,从 1 开始。

例如,如果你提供两个渲染插件和一个用户界面插件,并且打印机型号为 XYZ,则 .ini 文件可能显示如下:

[OEMFiles]
OEMDriverFile1=XYZDRV1.DLL
OEMConfigFile1=XYZUI1.DLL
OEMDriverFile2=XYZDRV2.DLL

等号 (=) 前后不允许有空格。 文件名不能包含路径规范。

在此示例中,指定了两个渲染插件。 根据 OEMDriverFilenn 值,xyzdrv1.dll 安装在 xyzdrv2.dll 之前。 Unidrv 和 Pscript5 驱动程序按安装的顺序调用插件,因此以后,当驱动程序需要调用这些插件提供的图形 DDI 挂钩函数和 COM 方法时,xyzdrv1.dll 会在 xyzdrv2.dll 之前调用。

.ini 文件名应反映打印机产品名称。 .ini 文件名应不同于其他打印机 .ini 文件的名称,以避免名称冲突。 如果要将渲染插件或用户界面插件反向移植到 Windows NT 4.0,则 .ini 文件名必须与 .gpd 或 .ppd 文件名匹配。 (也就是说,xyz.ini 必须用于 xyz.gpd 或 xyz.ppd。)此限制不适用于 Windows 2000 或更高版本的 Windows 操作系统。

.ini 文件可以包含 ANSI 或 Unicode 文本,但建议使用 Unicode 文本。 在 .ini 文件中,以井号 (#) 开头的行是注释。

有关详细信息,请参阅 INF 文件的一般准则安装 Unidrv 微型驱动程序

如果提供打印机 INF 文件,则安装和注册自定义组件的一种简便方法是将该组件设置为打印机驱动程序的依赖文件。 此外,关联的 .inf 文件可以作为依赖文件安装。 有关打印机驱动程序的依赖文件的详细信息,请参阅打印机 INF 文件条目

或者,可以通过将自定义组件设置为另一个打印组件(如端口监视器或状态应用程序)的依赖文件来安装该组件。 但是,此方法可能会造成困难,因为指向和打印操作仅在客户端上安装驱动程序和驱动程序依赖文件。 如果自定义组件未作为打印机驱动程序的依赖文件列出,则必须以某种方式将该组件安装在客户端上,而不是作为打印操作的一部分。