Метод IPrintOemUI2::QueryJobAttributes (prcomoem.h)

Статья
08/07/2023

Метод IPrintOemUI2::QueryJobAttributes позволяет подключаемого модуля пользовательского интерфейса выполнять постобработку результатов основного драйвера после вызова DDI DrvQueryJobAttributes . Подключаемый модуль может перезаписать значения, помещенные основным драйвером в выходной буфер lpAttributeInfo .

Синтаксис

HRESULT QueryJobAttributes(
  HANDLE   hPrinter,
  PDEVMODE pDevmode,
  DWORD    dwLevel,
  LPBYTE   lpAttributeInfo
);

Параметры

hPrinter

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

pDevmode

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

dwLevel

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

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

Обратите внимание, что если этот метод изменяет любой член dwDrvXxx структуры ATTRIBUTE_INFO_N , модуль очереди очереди предполагает, что подключаемый модуль может поддерживать поведение, представленное этим элементом.

lpAttributeInfo

Указатель на расположение памяти, которое получает адрес структуры типа, определяемого dwLevel.

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

Если подключаемый модуль пользовательского интерфейса поддерживает этот метод и метод выполнен успешно, он должен вернуть S_OK. Это приводит к тому, что основной драйвер возвращает true для DDI DrvQueryJobAttributes . Если подключаемый модуль пользовательского интерфейса поддерживает этот метод, но метод завершился сбоем, он должен вернуть E_FAIL. Это приводит к тому, что основной драйвер возвращает значение FALSE для DDI DrvQueryJobAttributes. Если подключаемый модуль пользовательского интерфейса не поддерживает этот метод, он должен вернуть E_NOTIMPL.

Если на принтере установлено несколько подключаемых модулей пользовательского интерфейса, основной драйвер вызывает подключаемые модули пользовательского интерфейса в том порядке, в котором они были установлены. HRESULT, возвращаемый последним подключаемым модулем пользовательского интерфейса, который поддерживает этот метод, используется для определения возвращаемого значения DDI DrvQueryJobAttributes драйвера, как описано в предыдущем разделе.

Дополнительные сведения см. в статье DrvQueryJobAttributes .