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

Статья
08/08/2023

Функция DrvQueryJobAttributes позволяет библиотеке DLL интерфейса принтера указать поддержку таких возможностей, как печать нескольких страниц документов на физической странице (печать n-up), печать нескольких копий каждой страницы, сортировка страниц и печать страниц в обратном порядке.

Синтаксис

BOOL DrvQueryJobAttributes(
  [in]  HANDLE   hPrinter,
  [in]  PDEVMODE pDevMode,
  [in]  DWORD    dwLevel,
  [out] LPBYTE   lpAttributeInfo
);

Параметры

[in] hPrinter

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

[in] pDevMode

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

[in] dwLevel

Значение вызывающего объекта, указывающее тип структуры, на которую указывает lpAttributeInfo, как показано в следующей таблице.

Значение dwLevel	ColumStructure, на который указывает lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

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

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

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

Библиотека DLL интерфейса принтера может дополнительно предоставить функцию DrvQueryJobAttributes. Если функция указана, она должна заполнить предоставленную структуру, описанную dwLevel и plAttributeInfo, чтобы указать атрибуты текущего задания печати, запрошенные пользователем (например, параметры N-up и количество копий), а также возможность драйвера поддерживать эти атрибуты. Функция обычно вызывается обработчиком печати EMF, поэтому она может определить, какие атрибуты задания могут обрабатываться драйвером (или принтером), а какие — обработчиком печати.