DevQueryPrintEx 函数 (winddiui.h)
打印机接口 DLL 的 DevQueryPrintEx 函数确定指定的打印作业是否与打印机的当前配置兼容,因此可以打印。
语法
BOOL DevQueryPrintEx(
[in, out] PDEVQUERYPRINT_INFO pDQPInfo
);
参数
[in, out] pDQPInfo
调用方提供的指向 DEVQUERYPRINT_INFO 结构的指针。
返回值
如果打印作业可以打印,则该函数应返回 TRUE;否则,它应返回 FALSE。
注解
打印机接口 DLL 必须定义 DevQueryPrintEx 函数。 如果在打印机属性表的“高级”页上选中了“保留不匹配的文档”选项,则打印后台处理程序将调用 该函数。 如果函数返回 TRUE,则后台处理程序会将打印作业排队进行打印。 否则,将保留作业,前提是打印机最终将重新配置,以便可以打印作业。
收到的 DEVQUERYPRINT_INFO 结构指向描述打印作业所需的打印机特征的 DEVMODEW 结构。 DevQueryPrintEx 函数应首先验证接收的 DEVMODEW 结构的大小和版本成员是否与驱动程序兼容。 然后,它应确定提供的 DEVMODEW 内容是否与当前打印机配置兼容。
如果可以打印作业,则该函数应仅返回 TRUE。 如果作业应一直保留到以后,则函数应在DEVQUERYPRINT_INFO结构的 pszErrorStr 成员) 描述无法打印作业的原因的缓冲区中提供可显示的文本字符串 (后返回 FALSE。
应将可显示的文本字符串定义为资源文件中的字符串资源。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | winddiui.h (包括 Winddiui.h) |
Library | Winspool.lib |
DLL | WinSpool.drv |