Поделиться через

Функция DevQueryPrintEx (winddiui.h)

  • Статья

Функция DevQueryPrintEx интерфейса принтера в библиотеке DLL определяет, совместимо ли указанное задание печати с текущей конфигурацией принтера и, следовательно, может ли оно быть напечатано.

Синтаксис

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

Параметры

[in, out] pDQPInfo

Указатель на структуру DEVQUERYPRINT_INFO , предоставленный вызывающим абонентом.

Возвращаемое значение

Если задание печати может быть напечатано, функция должна возвращать значение TRUE; В противном случае он должен возвращать значение FALSE.

Комментарии

Библиотеки DLL интерфейса принтера должны определять функцию DevQueryPrintEx . Функция вызывается диспетчером очереди печати, если на странице Дополнительно страницы свойств принтера установлен флажок Хранить несовпадение документов. Если функция возвращает значение TRUE, диспетчер очереди очереди помещает задание печати в очередь для печати. В противном случае задание будет выполняться при условии, что принтер в конечном итоге будет перенастроен, чтобы задание печатать.

Полученная структура DEVQUERYPRINT_INFO указывает на структуру DEVMODEW , описывающую характеристики принтера, необходимые для задания печати. Функция DevQueryPrintEx должна сначала убедиться, что размер и члены версии полученной структуры DEVMODEW совместимы с драйвером. Затем он должен определить, совместимо ли предоставленное содержимое DEVMODEW с текущей конфигурацией принтера.

Если задание можно распечатать, функция должна просто возвращать значение TRUE. Если задание должно быть удержано до конца, функция должна возвращать значение FALSE после предоставления отображаемой текстовой строки (в буфере, на который указывает элемент pszErrorStr структуры DEVQUERYPRINT_INFO), описывающую причину, по которой задание не удается распечатать.

Отображаемые текстовые строки должны быть определены как строковые ресурсы в файле ресурсов.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть winddiui.h (включая Winddiui.h)
Библиотека Winspool.lib
DLL Winspool.drv