Метод IPrintOemUI::D riverEvent (prcomoem.h)

Статья
02/07/2025

Функция драйвера принтера DrvDriverEvent вызывает метод IPrintOemUI::DriverEvent пользовательского интерфейса для дополнительной обработки событий драйвера принтера.

Синтаксис

HRESULT DriverEvent(
  DWORD  dwDriverEvent,
  DWORD  dwLevel,
  LPBYTE pDriverInfo,
  LPARAM lParam
);

Параметры

dwDriverEvent

Вызывающий битовый флаг, указывающий на событие, которое произошло. Допустимые флаги перечислены в следующей таблице.

Флаг	Определение
DRIVER_EVENT_DELETE	Драйвер удаляется.
DRIVER_EVENT_INITIALIZE	Драйвер только что установлен.

dwLevel

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

значение dwLevel	Структура, на которую указывает pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

Структуры DRIVER_INFO_N описаны в документации по пакету SDK для Microsoft Windows.

pDriverInfo

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

lParam

Флаги, предоставленные вызывающим абонентом. См. следующий раздел "Примечания".

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

Метод должен возвращать одно из следующих значений.

Возвращаемый код	Описание
S_OK	Операция завершилась успешно.
E_FAIL	Сбой операции.
E_NOTIMPL	Метод не реализован.

Замечания

Метод IPrintOemUI::DriverEvent пользовательского интерфейса выполняет те же типы операций, что и функция DrvDriverEvent, экспортируемая библиотеками DLL интерфейса принтера в режиме пользователя. Сведения о событиях драйвера и их обработке см. в описании функции DrvDriverEvent.

Если вы предоставляете подключаемый модуль пользовательского интерфейса, функция драйвера принтера DrvDriverEvent вызывает метод IPrintOemUI::DriverEvent. Функция DrvDriverE vent выполняет собственную обработку указанного события, а затем вызывает метод IPrintOemUI::DriverEvent для обработки дополнительной обработки события.

Если методы IPrintOemUI::DriverEvent экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указываются подключаемые модули для установки.

Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в настройке драйверов принтера Майкрософт.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

См. также

DrvDriverEvent

IPrintOemUI

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