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

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

  • Статья

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

Синтаксис

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 описаны в документации по Microsoft Windows SDK.

[in, optional] pDriverInfo

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

lParam

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

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

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

Комментарии

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

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть winddiui.h (включая Winddiui.h)