Fonction DrvQueryFontCaps (winddi.h)

Article
03/04/2024

La fonction DrvQueryFontCaps définit les fonctionnalités du pilote de police.

Syntaxe

LONG DrvQueryFontCaps(
  ULONG culCaps,
  ULONG *pulCaps
);

Paramètres

culCaps

Spécifie le nombre de valeurs ULONG dans le tableau vers lequel le paramètre pulCaps peut être écrit par le pilote de police.

pulCaps

Pointeur vers un tableau qui reçoit le nombre de valeurs spécifiées dans le premier paramètre. Les éléments du tableau ont les significations suivantes :

Élément	Signification
pulCaps[0]	Nombre de valeurs ULONG dans le tableau complet. Si culCaps est inférieur à cette valeur, l’appelant reçoit un tableau incomplet.
pulCaps[1]	Ensemble d’indicateurs qui peuvent être une ou plusieurs des valeurs suivantes : QC_OUTLINES Si cet indicateur est défini, le pilote de police peut retourner une description hiérarchique des glyphes. En outre, les polices sont supposées être évolutives. Les polices bitmap n’ont pas cet indicateur défini. QC_1BIT Indique que le pilote de police est capable de renvoyer des bitmaps monochromes de chaque glyphe. QC_4BIT Indique que le pilote de police est capable de renvoyer des bitmaps de 4 bits par pixel anti-aliased. Chaque pixel de la bitmap est représenté par une valeur 4 bits non signée dans la plage 0 à 15, donnant 16 nuances de gris.

Élément

Signification

pulCaps[0]

Nombre de valeurs ULONG dans le tableau complet. Si culCaps est inférieur à cette valeur, l’appelant reçoit un tableau incomplet.

pulCaps[1]

Ensemble d’indicateurs qui peuvent être une ou plusieurs des valeurs suivantes :

QC_OUTLINES
Si cet indicateur est défini, le pilote de police peut retourner une description hiérarchique des glyphes. En outre, les polices sont supposées être évolutives. Les polices bitmap n’ont pas cet indicateur défini.

QC_1BIT
Indique que le pilote de police est capable de renvoyer des bitmaps monochromes de chaque glyphe.

QC_4BIT
Indique que le pilote de police est capable de renvoyer des bitmaps de 4 bits par pixel anti-aliased. Chaque pixel de la bitmap est représenté par une valeur 4 bits non signée dans la plage 0 à 15, donnant 16 nuances de gris.

Valeur retournée

La valeur de retour correspond au nombre de valeurs ULONG écrites dans la mémoire tampon de destination si la fonction réussit. Sinon, c’est FD_ERROR.

Remarques

Un pilote peut signaler qu’il prend en charge plusieurs formats pour une police. Par exemple, un pilote peut, en principe, retourner avec QC_1BIT et QC_4BIT ensemble, indiquant qu’il est capable de renvoyer des versions monochromes et anti-aaliased de la police. Toutes les bitmaps générées par un pilote de police doivent démarrer et se terminer sur des limites 32 bits. Si nécessaire, la fin d’une bitmap doit être « rembourrée » pour répondre à cette exigence.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

DrvQueryFont

DrvQueryFontTree

Partager via