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

重要

建议使用 Microsoft 的 IPP 收件箱类驱动程序,以及 Print Support Apps (PSA) ,在 Windows 10 和 11 中自定义打印体验,以便进行打印机设备开发。

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

为 Microsoft 的打印机驱动程序提供自定义组件时,还必须提供用于安装组件的.ini文件。 (如果 ntprint.inf 不支持打印机,则还必须提供 打印机 INF file.)

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

  • OEMDriverFilen

    命名呈现插件。

  • OEMConfigFilen

    命名用户界面插件。

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

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

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

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

在本示例中,指定了两个呈现插件。 根据 OEMDriverFilen 的 n值,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 文件条目

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