通过

仅根级别属性

  • 项目

重要

建议使用 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 属性为功能和选项指定。
包括 带引号的字符串，包含其他 GPD 文件的名称。 已过时。 此项已重新定义为 预处理器指令。
InstalledOptionName 显示的带引号的字符串，指示已安装可安装的功能或选项。 通常，此字符串为“Installed”，但可以指定任何适当的字符串。 如果 *可安装，则为必需项？对于任何功能或选项， (请参阅功能属性) ，如果未指定 rcInstalledOptionNameID，则为 TRUE。
MasterUnits 表示打印机 主控单元的 PAIR。 必需。 若要减少潜在的舍入错误，请在字体指标数据中使用与为 MasterUnits 指定的分辨率单位相同的值。 (请参阅 自定义字体管理中的 Unidrv 字体指标。)
MaxCopies 表示打印机可以支持的最大份数的数值。 可选。 如果未指定，则默认值为 1。
ModelName 带引号的文本字符串，表示打印机型号名称。 如果未指定 rcModelNameID ，则是必需的。 字符串必须与 setup.inf 中的名称匹配。
NotInstalledOptionName 显示的带引号的字符串，指示未安装可安装的功能或选项。 通常，此字符串为“未安装”，但可以指定任何适当的字符串。 如果可安装？对于任何功能或选项， (请参阅功能属性) ;如果未指定 rcNotInstalledOptionNameID，则为 TRUE。
个性 带引号的字符串，表示打印机使用的打印机语言。 可选。 如果指定，则字符串由目录服务显示。 另请参阅下表中的 rcPersonalityID 。
PrinterType PAGE、SERIAL 或 TTY 必需
PrintRate 表示单色打印速率的数值。 单位由 PrintRateUnit 指定。 可选。 如果未指定，则默认值为 0。
PrintRatePPM 表示打印速度的数值（以每分钟页为单位）。 可选。 如果未指定，则默认值为 0。
PrintRateUnit PPM - Pages/min

CPS - 字符/秒

LPM - 行/分钟

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

有关示例，请参阅 示例 GPD 文件。

有关适用于 Windows Vista 的新仅根级别属性的信息，请参阅适用于 Windows Vista 的新仅根级 GPD 属性 和 适用于 Windows Vista 的全新仅根级别 PPD 属性。