Funciones definidas por DLL de gráficos de impresora
Importante
La plataforma de impresión moderna es el medio preferido de Windows para comunicarse con impresoras. Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con aplicaciones de soporte técnico de impresión (PSA), para personalizar la experiencia de impresión en Windows 10 y 11 para el desarrollo de dispositivos de impresora.
Para obtener más información, consulte Plataforma de impresión moderna y la Guía de diseño de aplicaciones para compatibilidad con impresión.
Al igual que todos los controladores de gráficos, los archivos DLL de gráficos de impresora son responsables de definir las siguientes funciones de DDI de gráficos. Después de DrvEnableDriver, el punto de entrada inicial del controlador, las funciones restantes se enumeran por orden alfabético. Tenga en cuenta que, dado que GDI llama a DrvEnableDriver por nombre, su nombre aparece en negrita. GDI llama a todas las demás funciones del controlador de pantalla mediante una matriz de punteros de función que DrvEnableDriver devuelve.
| Nombre de función | Descripción |
|---|---|
| DrvEnableDriver | Permite al controlador inicializarse y devolver punteros a funciones DDI de gráficos compatibles. |
| DrvCompletePDEV | Proporciona al controlador un identificador GDI a una instancia de dispositivo. |
| DrvDisableDriver | (Opcional) Permite al controlador realizar operaciones de limpieza antes de descargarse. |
| DrvDisablePDEV | Permite al controlador quitar información específica de la instancia del dispositivo. |
| DrvDisableSurface | Permite al controlador quitar una superficie de dibujo. |
| DrvEnablePDEV | Permite al controlador proporcionar a GDI características de dispositivo físico e inicializar información específica de la instancia del dispositivo. |
| DrvEnableSurface | Permite al controlador crear una superficie de dibujo. |
| DrvQueryDeviceSupport | (Opcional) Devuelve información específica del dispositivo solicitada. |
| DrvQueryDriverInfo | (Opcional) Devuelve información específica del controlador solicitada. |
Los archivos DLL de gráficos de impresora también son responsables de definir las siguientes funciones de DDI de gráficos específicos de impresión, a las que se llama en determinados puntos durante la representación de un trabajo de impresión.
| Función | Cuándo se llama |
|---|---|
| DrvEndDoc | Cuando GDI ha terminado de enviar un documento al controlador para su representación. |
| DrvNextBand | (Opcional) Cuando GDI ha terminado de dibujar una banda para una página física, para que el controlador pueda enviar la banda a la impresora. |
| DrvQueryPerBandInfo | (Opcional) Antes de que GDI comience a dibujar una banda para una página física, para que el controlador pueda proporcionar a GDI la información específica de banda. |
| DrvSendPage | Cuando GDI ha terminado de dibujar una página física, para que el controlador pueda enviar la página a la impresora. |
| DrvStartBanding | (Opcional) Cuando GDI está listo para empezar a enviar bandas de una página física al controlador para su representación. |
| DrvStartDoc | Cuando GDI está listo para empezar a enviar un documento al controlador para su representación. |
| DrvStartPage | Cuando GDI está listo para empezar a enviar una página del documento al controlador para su representación. |
Normalmente, un archivo DLL de gráficos de impresora también define las funciones de DDI de gráficos adicionales necesarias para realizar la representación del trabajo de impresión. El número y el tipo de funciones definidas dependen de:
Si el controlador admite el uso de superficies de dibujo administradas por GDI o administradas por dispositivos (o ambas). Para obtener más información, consulte Tipos de superficie.
La medida en que las operaciones de dibujo se pueden controlar mediante GDI en lugar de que las realice el propio controlador. Para obtener más información, consulte Uso de DDI de gráficos.
El motor de representación de gráficos en modo kernel (GRE) de GDI llama a todas las funciones definidas por los archivos DLL de gráficos de impresora.
El DLL de gráficos exporta las funciones DrvEnableDriver y DrvQueryDriverInfo. Las direcciones de todas las demás funciones de DDI de gráficos admitidas se colocan en una tabla devuelta por la función DrvEnableDriver.