仅限根级别属性
重要
新式打印平台是 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 属性。