仅限根级别属性

重要

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

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

仅限根级别属性是通用属性,用于描述特定于驱动程序的特征,如资源文件、帮助文件或其他包含的 GPD 文件的名称,以及驱动程序主单元、版本号和字符代码页的规范。

其他仅限根级别属性指定了特定于设备的特征,如打印机的名称、类型、最大复印容量和墨盒插槽的数量。

这些属性称为仅限根级别属性,因为它们必须始终放置在根级别的 GPD 文件中(即,不在大括号内)。

下表列出了仅限根级别属性。

属性名 AttributeParameter 注释
CodePage 数值 Windows 代码页标识符。 可选。 如果未指定,则使用 Unicode。 代码页应用于所有显示的字符串。
FontCartSlots 表示打印机提供的字体墨盒槽数的数值。 可选。 如果未指定,默认值为零。
GPDFileName 表示 GPD 文件名(无路径)的带引号的文本字符串。 可选。
GPDFileVersion 表示当前 GPD 文件版本的带引号的文本字符串。 建议的格式为 MajorVersion.MinorVersion,例如“1.0”。 可选。 如果指定,此字符串将显示在 Unidrv 的“关于”对话框中。
GPDSpecVersion 表示当前 GPD 规范版本的带引号的文本字符串。 规定的格式为 MajorVersion.MinorVersion,例如“1.0”。 必需。 在任何注释之前,必须是 GPD 文件中的第一个条目。对于 Windows 2000,此值必须为“1.0”。
帮助文件 包含自定义帮助文件名称的带引号的字符串,扩展名为 .hlp。 可选。 如果包含,它可以在 Unidrv 的帮助文件中添加主题或覆盖现有主题。 帮助文件索引由功能和选项的 *HelpIndex 属性指定。
Include 带引号的字符串,其中包含另一个 GPD 文件的名称。 已过时。 此条目已重新定义为预处理器指令
InstalledOptionName 显示的带引号的字符串,表示已安装可安装的功能或选项。 通常,此字符串为“Installed”,但可以指定任何适当的字符串。 如果 *Installable? 对于任何功能或选项为 TRUE(请参阅功能属性),且如果未指定 rcInstalledOptionNameID,则为必需项。
MasterUnits PAIR 表示打印机的主单元 必需。 为了减少潜在的四舍五入错误,请在字体规格数据中使用与为 MasterUnits 指定的分辨率单位相同的值。 (请参阅自定义的字体管理中的 Unidrv 字体规格。)
MaxCopies 表示打印机可以支持的最大份数的数值。 可选。 如果未指定,则默认值为 1。
ModelName 表示打印机型号名称的带引号的文本字符串。 如果未指定 rcModelNameID,则为必需项。 字符串必须与 setup.inf 中的名称匹配。
NotInstalledOptionName 显示的带引号的字符串,表示未安装可安装的功能或选项。 通常,此字符串为“Not installed”,但可以指定任何适当的字符串。 如果 Installable? 对于任何功能或选项为 TRUE(请参阅功能属性),且如果未指定 rcNotInstalledOptionNameID,则为必需项。
个性 带引号的字符串,表示打印机使用的打印机语言。 可选。 如果指定,则由目录服务显示字符串。 另请参阅该表下面的 rcPersonalityID
PrinterType PAGE、SERIAL 或 TTY 必须
PrintRate 表示单色打印速率的数值。 单位由 PrintRateUnit 指定。 可选。 如果未指定,则默认值为 0。
PrintRatePPM 表示打印速度的数值,单位为每分钟页数。 可选。 如果未指定,则默认值为 0。
PrintRateUnit PPM - 页数/分钟

CPS - 字符数/秒

LPM - 行数/分钟

IPM - 英寸/分钟(IPM 用于绘图仪)
如果指定了 PrintRate,则为必需项。 指定的单位应与打印机类型匹配。 例如,应为页面打印机指定 PPM。
rcInstalledOptionNameID 显示的字符串资源的资源 ID,用于指示已安装可安装的功能或选项。 通常,此字符串为“Installed”,但可以指定任何适当的字符串。 如果 Installable? 对于任何功能或选项为 TRUE(请参阅功能属性),且如果未指定 InstalledOptionName,则为必需项。
rcNotInstalledOptionNameID 显示的字符串资源的资源 ID,用于指示未安装可安装的功能或选项。 通常,此字符串为“Not installed”,但可以指定任何适当的字符串。 如果 Installable? 对于任何功能或选项为 TRUE(请参阅功能属性),且如果未指定 NotInstalledOptionName,则为必需项。
rcPersonalityID 表示打印机使用的打印机语言的字符串资源的资源 ID。 可选。 如果指定,则由目录服务显示字符串。 另请参阅个性化
rcPrinterIconID 表示与打印机关联的图标的 RC_ICON 资源的资源 ID。 可选。 如果未指定,将显示默认打印机图标。 建议所有 RC_ICON 资源 ID 从 1 开始连续编号。
ResourceDLL 带引号的字符串,其中包含资源 DLL 的名称,但不包含路径信息。 可选。 请参阅在微型驱动程序中使用资源 DLL

有关 Windows Vista 的新仅限根级别属性的信息,请参阅适用于 Windows Vista 的仅限根级别的新 GPD 属性适用于 Windows Vista 的仅限根级别的新 PPD 属性