命令属性
重要
新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。
有关详细信息,请参阅新式打印平台和打印支持应用设计指南。
在指定打印机命令时,可以使用属性为 Unidrv 提供以下信息:
如果操作是在打印机硬件中执行的,则是使硬件执行操作的转义序列。
回调标识符和 IPrintOemUni::CommandCallback 方法所需的参数(如果操作是在呈现插件中实现的)。
相对于其他命令的命令发送顺序。
下表列出了按字母顺序排列的命令属性,并对其参数进行了介绍。
属性名 | 属性参数 | 注释 |
---|---|---|
CallbackID | 正数值,作为其 dCmdCbID 参数传递给呈现插件的 IPrintOemUni::CommandCallback 方法。 | 对于动态生成的打印机命令为必填。 如果指定了 Cmd,则无效。 |
Cmd | 包含打印机命令转义序列的文本字符串,使用命令字符串格式来指定。 | 除非指定了 CallbackID,否则为必填。 |
NoPageEject? | TRUE 或 FALSE,表示执行命令是否会导致打印机弹出当前的物理页面。 仅在 Order 指定 DOC_SETUP 部分和启用 DUPLEX 打印时使用。 为避免在双面文档页面之间过早弹出页面,Unidrv 在可能的情况下仅发出将此属性设置为 TRUE 的命令。 |
可选。 如果未指定,则默认值为 FALSE,这意味着该命令可能会导致页面弹出。 如果命令会产生副作用(也就是说,如果命令修改的打印机设置不在 NoPageEject? 设为 TRUE 的命令控制范围内),则不能为 TRUE。 |
Order | 部分名称和命令编号,如命令执行顺序中所述。 | 除非在命令说明中专门指明,否则仅对配置命令和自定义选项命令有效。 |
参数 | 标准变量的列表,在作为 pdwParams 参数传递的 EXTRAPARAM 结构中传递给呈现插件 IPrintOemUni::CommandCallback 方法。 | 仅当同时指定 CallbackID 时有效。 |