Estructura DEVINFO (winddi.h)

Artículo
08/27/2023

La estructura DEVINFO proporciona información sobre el controlador y su PDEV privado al motor gráfico.

Sintaxis

typedef struct tagDEVINFO {
  FLONG    flGraphicsCaps;
  LOGFONTW lfDefaultFont;
  LOGFONTW lfAnsiVarFont;
  LOGFONTW lfAnsiFixFont;
  ULONG    cFonts;
  ULONG    iDitherFormat;
  USHORT   cxDither;
  USHORT   cyDither;
  HPALETTE hpalDefault;
  FLONG    flGraphicsCaps2;
} DEVINFO, *PDEVINFO;

Miembros

flGraphicsCaps

Es un conjunto de marcas que describen las funcionalidades gráficas del controlador de gráficos o su hardware. Estas marcas se definen en la tabla siguiente.

Marca	Definición
GCAPS_ALTERNATEFILL	Controla rellenos alternativos.
GCAPS_ARBRUSHOPAQUE	Admite un pincel arbitrario para el rectángulo opaco de texto (color de fondo).
GCAPS_ARBRUSHTEXT	Admite un pincel arbitrario para el color de primer plano del texto.
GCAPS_ASYNCCHANGE	Este marcador está obsoleto. En los controladores heredados, esta marca indica que el controlador puede cambiar la forma del puntero en el hardware mientras se está produciendo otro dibujo en el dispositivo.
GCAPS_ASYNCMOVE	El controlador puede mover el puntero en hardware mientras se está produciendo otro dibujo en el dispositivo.
GCAPS_BEZIERS	Controla las curvas Bezier.
GCAPS_CMYKCOLOR	El controlador admite el espacio de color CYMK.
GCAPS_COLOR_DITHER	Controla el dithering de color en una superficie compatible con PDEV.
GCAPS_DIRECTDRAW	Este marcador está obsoleto.
GCAPS_DITHERONREALIZE	Especifica que GDI puede llamar a DrvRealizeBrush con rgb para que se dithere directamente.
GCAPS_DONTJOURNAL	No permite la impresión de metarchivos en este controlador de impresora. Esto solo es válido para controladores de dominio de impresora y, por lo general, dará lugar a un tiempo de retorno a la aplicación más lento al imprimir.
GCAPS_FONT_RASTERIZER	El hardware del dispositivo puede rasterizar fuentes TrueType.
GCAPS_FORCEDITHER	Permite el anclaje en todos los lápices geométricos.
GCAPS_GEOMETRICWIDE	Controla la ampliación geométrica.
GCAPS_GRAY16	Controla el texto suavizado de forma nativa.
GCAPS_HALFTONE	Controla el mediotonamiento.
GCAPS_HIGHRESTEXT	Este marcador está obsoleto. En los controladores heredados, esta marca indica que el controlador solicita posiciones de glifo tal y como devuelve el STROBJ en las coordenadas del punto FIX.
GCAPS_HORIZSTRIKE	Este marcador está obsoleto. En los controladores heredados, esta marca indica que el controlador controla los tachos horizontales en DrvTextOut.
GCAPS_ICM	Indica que el controlador o el hardware de la impresora pueden realizar operaciones de administración de colores.
GCAPS_LAYERED	Indica que se trata de un controlador de capa o reflejo para la comunicación remota. Los controladores de impresora no pueden ser controladores de capa.
GCAPS_MONO_DITHER	Controla el dithering monocromo.
GCAPS_NO64BITMEMACCESS	Este marcador está obsoleto.
GCAPS_NUP	Indica que se admite la impresión "N-up".
GCAPS_OPAQUERECT	Controla rectángulos opacos en DrvTextOut.
GCAPS_PALMANAGED	Admite la administración de paletas.
GCAPS_PANNING	Cuando GDI simula el puntero, debe llamar a DrvMovePointer para notificar al controlador la posición actual del cursor. Esto permite al controlador controlar las pantallas virtuales de movimiento panorámico.
GCAPS_SCREENPRECISION	El rasterizador (motor de fuentes) debe elegir una fuente de pantalla (suave) en una fuente del dispositivo al elegir una fuente para la que no hay coincidencia exacta.
GCAPS_VECTORFONT	Controla la pulsación de fuentes vectoriales en DrvTextOut.
GCAPS_VERTSTRIKE	Este marcador está obsoleto. En los controladores heredados, esta marca indica que el controlador controló los tachados verticales en DrvTextOut.
GCAPS_WINDINGFILL	Controla los rellenos del modo de devanado. Consulte Modos de relleno de ruta de acceso para obtener más información.
GCAPS2_REMOTEDRIVER	Indica que el controlador de pantalla se usa para admitir una sesión de usuario remota.

lfDefaultFont

Es una estructura de fuente lógica extendida que especifica la fuente predeterminada para un dispositivo. Para obtener más información sobre esta estructura, vea EXTLOGFONT en la documentación de Microsoft Windows SDK.

lfAnsiVarFont

Es una estructura de fuente lógica extendida que especifica la fuente de inclinación variable predeterminada para un dispositivo. Para obtener más información sobre esta estructura, vea EXTLOGFONT en la documentación de Windows SDK.

lfAnsiFixFont

Es una estructura de fuente lógica extendida que especifica la fuente de tono fijo (monoespacial) predeterminada para un dispositivo. Para obtener más información sobre esta estructura, vea EXTLOGFONT en la documentación de Windows SDK.

cFonts

Especifica el número de fuentes del dispositivo. GDI supone que el dispositivo puede dibujar texto con este número de fuentes en sus propias superficies y que el controlador puede proporcionar información de métricas sobre las fuentes. Si el controlador establece cFonts en -1, GDI esperará hasta que se necesiten fuentes para consultar al controlador el número real de fuentes que admite en una llamada a DrvQueryFont.

iDitherFormat

Especifica el formato del mapa de bits. Este parámetro indica cuántos bits de información de color por píxel se solicitan y debe ser uno de los siguientes valores:

Valor	Significado
BMF_1BPP	Monocromático
BMF_4BPP	4 bits por píxel
BMF_8BPP	8 bits por píxel
BMF_16BPP	16 bits por píxel
BMF_24BPP	24 bits por píxel
BMF_32BPP	32 bits por píxel
BMF_4RLE	4 bits por píxel, longitud de ejecución codificada
BMF_8RLE	8 bits por píxel, longitud de ejecución codificada
BMF_JPEG	Imagen comprimida JPEG
BMF_PNG	Imagen comprimida de PNG

cxDither

cyDither

Especifique las dimensiones de un pincel dithered. Si estos miembros no son cero, el dispositivo puede crear un pincel dithered para un color RGB determinado.

hpalDefault

Controle la paleta predeterminada del dispositivo. El controlador debe crear la paleta llamando a EngCreatePalette. El controlador asocia una paleta a un dispositivo devolviendo este identificador a GDI.

flGraphicsCaps2

Es un conjunto de marcas que describen funcionalidades gráficas adicionales del controlador de dispositivo. Estas marcas se definen en la tabla siguiente.

Marca	Definición
GCAPS2_ALPHACURSOR	Controla punteros con valores alfa por píxel.
GCAPS2_CHANGEGAMMARAMP	El dispositivo de pantalla tiene una rampa gamma de hardware cargable.
GCAPS2_EXCLUDELAYERED	Indica que se trata de un controlador reflejado de accesibilidad. Los controladores reflejados que no establecen esta marca seguirán recibiendo primitivos de dibujo para los HWND superpuestas. Consulte Controladores reflejados para obtener más información.
GCAPS2_ICD_MULTIMON	Informa a GDI de que el controlador pretende controlar las llamadas DrvSetPixelFormat, DrvDescribePixelFormat y DrvSwapBuffers en un entorno multimon, incluso cuando el rectángulo de la operación también interseca otro dispositivo. Solo un dispositivo tiene la oportunidad de controlar esas llamadas. Si no se especifica la funcionalidad y la región implicada intersecta más de un dispositivo, no se llama a ningún controlador.
GCAPS2_INCLUDEAPIBITMAPS	Cuando se realizan llamadas de dibujo a un mapa de bits independiente del dispositivo (DIB), se llamará a un controlador reflejado de accesibilidad. Consulte Controladores reflejados para obtener más información.
GCAPS2_JPEGSRC	El dispositivo puede aceptar imágenes comprimidas JPEG (es decir, imágenes para las que se establece BMF_JPEG en la estructura SURFOBJ ).
GCAPS2_MOUSETRAILS	Indica que el controlador admite seguimientos del mouse (una sucesión de imágenes de cursor que muestran la ubicación del mouse durante un breve período de tiempo). El controlador es capaz de controlar los valores que GDI envía en el parámetro fl de la función DrvSetPointerShape . El controlador debe usar las máscaras SPS_LENGTHMASK y SPS_FREQMASK para obtener valores para la longitud y la frecuencia de las pistas del mouse. Consulte DrvSetPointerShape para obtener más información sobre estas máscaras.
GCAPS2_PNGSRC	El dispositivo puede aceptar imágenes comprimidas PNG (es decir, imágenes para las que se establece BMF_PNG en la estructura SURFOBJ ).
GCAPS2_SYNCFLUSH	El controlador admite un mecanismo de vaciado basado en programación para llamadas DDI de gráficos por lotes. Se llamará a DrvSynchronizeSurface siempre que GDI deba vaciar cualquier dibujo que el controlador esté procesando por lotes.
GCAPS2_SYNCTIMER	El controlador admite un mecanismo de vaciado basado en temporizador para llamadas DDI de gráficos por lotes. Se llamará a DrvSynchronizeSurface periódicamente, en función de un intervalo de temporizador determinado por GDI.

Comentarios

La función DrvEnablePDEV del controlador rellena una estructura DEVINFO; El controlador solo debe establecer los miembros pertinentes para él. GDI inicializa esta estructura sin inicializar antes de llamar a DrvEnablePDEV . Las aplicaciones no tienen acceso directo a esta estructura.

Si un controlador establece GCAPS2_JPEGSRC o GCAPS2_PNGSRC en flGraphicsCaps2, se aplican las reglas siguientes:

El controlador debe proporcionar una función DrvQueryDeviceSupport .
Cada función DDI de gráficos definida por el controlador que recibe una estructura SURFOBJ como entrada debe ser capaz de admitir el formato comprimido o devolver un código de error. En el caso de los controladores de impresora, para admitir el formato comprimido, el controlador debe poder realizar una de las siguientes tareas:
- Si el dispositivo de impresión puede procesar el formato comprimido JPEG/PNG, el controlador de impresora debe pasar el formato comprimido a la salida del lenguaje de descripción de página (PDL).
- Si el dispositivo de impresión no puede procesar el formato comprimido JPEG/PNG, el controlador de impresora primero debe convertir el formato JPEG/PNG comprimido en otro formato de imagen que el dispositivo de impresión pueda procesar. A continuación, el controlador de impresora puede hacer que la información de imagen esté disponible en la salida PDL del controlador.
  Nota En el caso de la conversión de JPEG/PNG al formato de mapa de bits, el controlador de impresora no debe usar funciones GDI. Por ejemplo, el controlador puede usar las API del componente de creación de imágenes de Windows (WIC) en su lugar para realizar la conversión.
El controlador debe ser capaz de controlar regiones de recorte complejas para las imágenes que usan el formato comprimido.
En el caso de las funciones DDI de gráficos definidos por el controlador que reciben un argumento de entrada ROP4, solo se usa 0xCCCC con formatos JPEG y PNG.