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) |