命令属性

重要

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

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

指定打印机命令时,请使用属性为 Unidrv 提供以下信息:

  • 如果操作是在打印机硬件中实现的,则为导致硬件执行操作的转义序列。

  • IPrintOemUni::CommandCallback 方法所需的回调标识符和参数(如果在呈现插件中实现操作)。

  • 命令的发送顺序,相对于其他命令。

下表按字母顺序列出了命令属性,并描述了其参数。

特性名 属性参数 注释
CallbackID 正数值,传递给呈现插件的 IPrintOemUni::CommandCallback 方法作为其 dCmdCbID 参数。 对于动态生成的打印机命令是必需的。 如果指定 了 Cmd ,则无效。
Cmd 包含打印机命令转义序列的文本字符串,使用 命令字符串格式指定。 必需,除非指定 CallbackID
NoPageEject? TRUEFALSE,指示执行命令是否会导致打印机弹出当前物理页面。

仅当 Order 指定DOC_SETUP节并且启用了双工打印时使用。 为了避免在双面文档页之间过早弹出页面,Unidrv 仅在可能的情况下发出此属性设置为 TRUE 的命令。
可选。 如果未指定,则默认值为 FALSE,这意味着该命令可能会导致页面弹出。

如果命令导致副作用 (则不得为 TRUE ,也就是说,如果命令修改了由 NoPageEject? 设置为 TRUE) 的命令所控制的那些命令之外的打印机设置,则不得为 TRUE
节名称和订单号,如 命令执行顺序中所述。 仅对配置命令和自定义选项命令有效,除非命令说明中另有说明。
Params 传递到呈现插件的 IPrintOemUni::CommandCallback 方法的标准变量列表,该方法作为其 pdwParams 参数传递。 仅当还指定 了 CallbackID 时有效。

有关示例,请参阅 示例 GPD 文件