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