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

Статья
02/07/2025

Средство spooler печати вызывает функцию DLL интерфейса принтера DrvDriverEvent, когда spooler обрабатывает события драйвера, которые могут требовать действия драйвером принтера.

Синтаксис

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] 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.

[in, optional] pDriverInfo

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

lParam

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

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

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

Замечания

Необязательная функция DrvDriverEvent вызывается функцией AddPrinterDriverEx и DeletePrinterDriverEx, описанными в документации по пакету SDK для Windows.

Цель функции — разрешить драйверу принтера интерфейсу DLL принтера выполнять операции, необходимые при установке или удалении драйвера. Обычной операцией для этой функции является создание или удаление дополнительных файлов драйвера, которые не указаны в качестве зависимых файлов в INF-файле принтера.

Если DRIVER_EVENT_DELETE DRIVER_EVENT_DELETE dwDriverEvent, параметр lparam содержит флаги, указанные для параметра DeletePrinterDriverExdwDeleteFlag функции. Параметр lparam не используется, если dwDriverEvent DRIVER_EVENT_INITIALIZE.

Так как функция DrvDriverEvent вызывается в контексте spooler печати, она не может отображать пользовательский интерфейс.

Требования

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

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