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

Статья
02/07/2025

Функция 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, поэтому она может определить, какие атрибуты задания можно обрабатывать драйвером (или принтером), и которые должны обрабатываться обработчиком печати.