Structure DEVINFO (winddi.h)

Article
08/27/2023

La structure DEVINFO fournit des informations sur le pilote et son PDEV privé au moteur graphique.

Syntaxe

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;

Membres

flGraphicsCaps

Ensemble d’indicateurs qui décrivent les fonctionnalités graphiques du pilote graphique et/ou de son matériel. Ces indicateurs sont définis dans le tableau suivant.

Indicateur	Définition
GCAPS_ALTERNATEFILL	Gère les remplissages alternés.
GCAPS_ARBRUSHOPAQUE	Prend en charge un pinceau arbitraire pour le rectangle opaque de texte (couleur d’arrière-plan).
GCAPS_ARBRUSHTEXT	Prend en charge un pinceau arbitraire pour la couleur de premier plan du texte.
GCAPS_ASYNCCHANGE	Cet indicateur est obsolète. Dans les pilotes hérités, cet indicateur indique que le pilote peut modifier la forme du pointeur dans le matériel pendant que d’autres dessins se produisent sur l’appareil.
GCAPS_ASYNCMOVE	Le pilote peut déplacer le pointeur dans le matériel pendant qu’un autre dessin se produit sur l’appareil.
GCAPS_BEZIERS	Gère les courbes de Bézier.
GCAPS_CMYKCOLOR	Le pilote prend en charge l’espace de couleur CYMK.
GCAPS_COLOR_DITHER	Gère le dithering des couleurs sur une surface compatible PDEV.
GCAPS_DIRECTDRAW	Cet indicateur est obsolète.
GCAPS_DITHERONREALIZE	Spécifie que GDI peut appeler DrvRealizeBrush avec le RVB à tramer directement.
GCAPS_DONTJOURNAL	Interdit l’impression de métafichiers sur ce pilote d’imprimante. Cela n’est valable que pour les contrôleurs de domaine d’imprimante et entraîne généralement un délai de retour à l’application plus lent lors de l’impression.
GCAPS_FONT_RASTERIZER	Le matériel de l’appareil peut rasteriser les polices TrueType.
GCAPS_FORCEDITHER	Permet le dithering sur tous les stylets géométriques.
GCAPS_GEOMETRICWIDE	Gère l’élargissement géométrique.
GCAPS_GRAY16	Gère le texte anti-attirail en mode natif.
GCAPS_HALFTONE	Gère la demi-toning.
GCAPS_HIGHRESTEXT	Cet indicateur est obsolète. Dans les pilotes hérités, cet indicateur indique que le pilote demande des positions de glyphes telles que retournées par le STROBJ dans les coordonnées de point FIX.
GCAPS_HORIZSTRIKE	Cet indicateur est obsolète. Dans les pilotes hérités, cet indicateur indique que le pilote gère les grèves horizontales dans DrvTextOut.
GCAPS_ICM	Indique que les opérations de gestion des couleurs peuvent être effectuées par le pilote ou le matériel d’imprimante.
GCAPS_LAYERED	Indique qu’il s’agit d’un pilote de couche ou de miroir pour la communication à distance. Les pilotes d’imprimante ne peuvent pas être des pilotes de couche.
GCAPS_MONO_DITHER	Gère le dithering monochrome.
GCAPS_NO64BITMEMACCESS	Cet indicateur est obsolète.
GCAPS_NUP	Indique que l’impression « N-up » est prise en charge.
GCAPS_OPAQUERECT	Gère les rectangles opaques dans DrvTextOut.
GCAPS_PALMANAGED	Prend en charge la gestion des palettes.
GCAPS_PANNING	Lorsque GDI simule le pointeur, il doit appeler DrvMovePointer pour informer le pilote de la position actuelle du curseur. Cela permet au pilote de gérer les affichages virtuels panoramiques.
GCAPS_SCREENPRECISION	Le rastériseur (moteur de polices) doit choisir une police d’écran (réversible) sur une police d’appareil lors du choix d’une police pour laquelle il n’existe aucune correspondance exacte.
GCAPS_VECTORFONT	Gère la caresse des polices vectorielles dans DrvTextOut.
GCAPS_VERTSTRIKE	Cet indicateur est obsolète. Dans les pilotes hérités, cet indicateur indiquait que le pilote gérait les grèves verticales dans DrvTextOut.
GCAPS_WINDINGFILL	Gère les remplissages en mode enroulement. Pour plus d’informations, consultez Modes de remplissage de chemin d’accès.
GCAPS2_REMOTEDRIVER	Indique que le pilote d’affichage est utilisé pour prendre en charge une session utilisateur à distance.

lfDefaultFont

Structure de police logique étendue qui spécifie la police par défaut d’un appareil. Pour plus d’informations sur cette structure, consultez EXTLOGFONT dans la documentation Microsoft Windows SDK.

lfAnsiVarFont

Structure de police logique étendue qui spécifie la police de pas variable par défaut pour un appareil. Pour plus d’informations sur cette structure, consultez EXTLOGFONT dans la documentation SDK Windows.

lfAnsiFixFont

Structure de police logique étendue qui spécifie la police à pas fixe (monospaced) par défaut pour un appareil. Pour plus d’informations sur cette structure, consultez EXTLOGFONT dans la documentation SDK Windows.

cFonts

Spécifie le nombre de polices d’appareil. GDI suppose que l’appareil peut dessiner du texte avec ce nombre de polices sur ses propres surfaces et que le pilote peut fournir des informations sur les métriques sur les polices. Si le pilote définit cFonts sur -1, GDI attend que des polices soient nécessaires pour interroger le pilote sur le nombre réel de polices qu’il prend en charge dans un appel à DrvQueryFont.

iDitherFormat

Spécifie le format de l’image bitmap. Ce paramètre indique le nombre de bits d’informations de couleur par pixel qui sont demandés et doit correspondre à l’une des valeurs suivantes :

Valeur	Signification
BMF_1BPP	Monochrome
BMF_4BPP	4 bits par pixel
BMF_8BPP	8 bits par pixel
BMF_16BPP	16 bits par pixel
BMF_24BPP	24 bits par pixel
BMF_32BPP	32 bits par pixel
BMF_4RLE	4 bits par pixel, longueur d’exécution encodée
BMF_8RLE	8 bits par pixel, longueur d’exécution encodée
BMF_JPEG	Image compressée JPEG
BMF_PNG	Image compressée PNG

cxDither

cyDither

Spécifiez les dimensions d’un pinceau à trame. Si ces membres ne sont pas nuls, l’appareil peut créer un pinceau dithered pour une couleur RVB donnée.

hpalDefault

Gérez la palette par défaut pour l’appareil. Le pilote doit créer la palette en appelant EngCreatePalette. Le pilote associe une palette à un appareil en retournant cette poignée à GDI.

flGraphicsCaps2

Ensemble d’indicateurs qui décrivent des fonctionnalités graphiques supplémentaires du pilote de périphérique. Ces indicateurs sont définis dans le tableau suivant.

Indicateur	Définition
GCAPS2_ALPHACURSOR	Gère les pointeurs avec des valeurs alpha par pixel.
GCAPS2_CHANGEGAMMARAMP	Le périphérique d’affichage a une rampe gamma matérielle chargeable.
GCAPS2_EXCLUDELAYERED	Indique qu’il s’agit d’un pilote miroir d’accessibilité. Les pilotes miroir qui ne définissent pas cet indicateur recevront toujours des primitives de dessin pour les disques HWND en couches. Pour plus d’informations, consultez Pilotes miroirs .
GCAPS2_ICD_MULTIMON	Informe GDI que le pilote a l’intention de gérer les appels DrvSetPixelFormat, DrvDescribePixelFormat et DrvSwapBuffers dans un environnement multimon, même lorsque le rectangle de l’opération croise également un autre appareil. Un seul appareil a la possibilité de gérer ces appels. Si la fonctionnalité n’est pas spécifiée et que la région impliquée croise plusieurs appareils, aucun pilote n’est appelé.
GCAPS2_INCLUDEAPIBITMAPS	Lorsque des appels de dessin sont effectués vers une bitmap indépendante de l’appareil (DIB), un pilote d’accessibilité miroir est appelé. Pour plus d’informations, consultez Pilotes miroirs .
GCAPS2_JPEGSRC	L’appareil peut accepter les images compressées JPEG (c’est-à-dire les images pour lesquelles BMF_JPEG est défini dans la structure SURFOBJ ).
GCAPS2_MOUSETRAILS	Indique que le pilote prend en charge les traces de souris (une succession d’images de curseur montrant l’emplacement de la souris pendant une courte période). Le pilote est capable de gérer les valeurs envoyées par GDI dans le paramètre fl de la fonction DrvSetPointerShape . Le conducteur doit utiliser les masques SPS_LENGTHMASK et SPS_FREQMASK pour obtenir des valeurs pour la longueur et la fréquence des traces de souris. Pour plus d’informations sur ces masques, consultez DrvSetPointerShape .
GCAPS2_PNGSRC	L’appareil peut accepter les images compressées PNG (c’est-à-dire les images pour lesquelles BMF_PNG est défini dans la structure SURFOBJ ).
GCAPS2_SYNCFLUSH	Le pilote prend en charge un mécanisme de vidage par programmation pour les appels DDI graphiques par lots. DrvSynchronizeSurface est appelé chaque fois que GDI doit vider tout dessin en cours de traitement par lot par le pilote.
GCAPS2_SYNCTIMER	Le pilote prend en charge un mécanisme de vidage basé sur le minuteur pour les appels DDI graphiques par lots. DrvSynchronizeSurface sera appelé régulièrement, en fonction d’un intervalle de minuteur déterminé par GDI.

Remarques

La fonction DrvEnablePDEV du pilote remplit une structure DEVINFO ; le pilote doit définir uniquement les membres qui lui sont pertinents. Cette structure est zéro initialisée par GDI avant l’appel de DrvEnablePDEV . Les applications n’ont pas d’accès direct à cette structure.

Si un pilote définit GCAPS2_JPEGSRC ou GCAPS2_PNGSRC dans flGraphicsCaps2, les règles suivantes s’appliquent :

Le pilote doit fournir une fonction DrvQueryDeviceSupport .
Chaque fonction DDI graphique définie par le pilote qui reçoit une structure SURFOBJ en tant qu’entrée doit être en mesure de prendre en charge le format compressé ou de retourner un code d’erreur. Dans le cas des pilotes d’imprimante, pour prendre en charge le format compressé, le pilote doit être en mesure d’effectuer l’une des tâches suivantes :
- Si le périphérique d’impression peut traiter le format compressé JPEG/PNG, le pilote d’imprimante doit passer le format compressé à sa sortie PDL (Page Description Language).
- Si le périphérique d’impression ne peut pas traiter le format compressé JPEG/PNG, le pilote d’imprimante doit d’abord convertir le format JPEG/PNG compressé en un autre format d’image que le périphérique d’impression peut traiter. Le pilote d’imprimante peut ensuite rendre les informations d’image disponibles dans la sortie PDL du pilote.
  Note En cas de conversion de JPEG/PNG au format bitmap, le pilote d’imprimante ne doit pas utiliser les fonctions GDI. Par exemple, le pilote peut utiliser les API wic (Windows Imaging Component) à la place pour effectuer la conversion.
Le pilote doit être en mesure de gérer des régions de clip complexes pour les images qui utilisent le format compressé.
Pour les fonctions DDI graphiques définies par le pilote qui reçoivent un argument d’entrée ROP4, seule 0xCCCC est utilisée avec les formats JPEG et PNG.