Función DrvDriverEvent (winddiui.h)

El administrador de trabajos de impresión llama a la función DrvDriverEvent de un archivo DLL de interfaz de impresora cuando el administrador de trabajos procesa eventos específicos del controlador que pueden requerir la acción del controlador de impresora.

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 se acaba de instalar.

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.

Observaciones

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

El propósito de la función es permitir que el archivo DLL de la interfaz de impresora de un controlador de impresora realice las operaciones necesarias cuando el controlador se instala o se quita. 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 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

Plataforma de destino	Escritorio
Encabezado	winddiui.h (incluir Winddiui.h)