Función DrvDriverEvent (winddiui.h)

El administrador de trabajos de impresión llama a la función DrvDriverEvent de una interfaz de impresora cuando el controlador de impresora procesa eventos específicos del controlador que podrían requerir la acción del controlador.

Sintaxis

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

Parámetros

dwDriverEvent

Marca de bits proporcionada por el autor de la llamada que indica el evento que se ha producido. Las marcas válidas se muestran en la tabla siguiente.

Marca	Definición
DRIVER_EVENT_DELETE	Se está quitando el controlador.
DRIVER_EVENT_INITIALIZE	El controlador acaba de instalarse.

dwLevel

Valor proporcionado por el autor de la llamada que indica el tipo de estructura al que apunta el parámetro pDriverInfo , como se indica en la tabla siguiente.

dwLevel Valor	Estructura a la que apunta pDriverInfo
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3

Las estructuras DRIVER_INFO_N se describen en la documentación de Microsoft Windows SDK.

[in, optional] pDriverInfo

Puntero proporcionado por el autor de la llamada a una estructura cuyo tipo se identifica mediante el parámetro dwLevel .

lParam

Marcas proporcionadas por el autor de la llamada. Consulte la sección Comentarios siguiente.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe devolver FALSE.

Comentarios

Las funciones AddPrinterDriverEx y DeletePrinterDriverEx de spooler llaman a la función opcional DrvDriverEvent, que se describen en la documentación de Windows SDK.

El propósito de la función es permitir que el archivo DLL de interfaz de impresora del controlador de impresora realice las operaciones necesarias cuando se instala o se quita el controlador. Una operación típica para que esta función realice es crear o quitar archivos adicionales específicos del controlador que no se especifican como archivos dependientes en un archivo INF de impresora.

Si dwDriverEvent es DRIVER_EVENT_DELETE, el parámetro lparam contiene las marcas especificadas para el parámetro dwDeleteFlag de la función DeletePrinterDriverEx. El parámetro lparam no se usa si dwDriverEvent está DRIVER_EVENT_INITIALIZE.

Dado que se llama a la función DrvDriverEvent en el contexto del administrador de trabajos de impresión, no puede mostrar una interfaz de usuario.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winddiui.h (incluya Winddiui.h)