Partager via


Fonction DrvQueryFontTree (winddi.h)

La fonction DrvQueryFontTree fournit à GDI un pointeur vers une structure qui définit l’un des éléments suivants :

  • Mappage de handles Unicode à glyphes, y compris les variantes de glyphes
  • Mappage de paires de crénage à des poignées de crénage

Syntaxe

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

Paramètres

dhpdev

Identifie un appareil par un handle à son PDEV, retourné à partir d’un appel antérieur à DrvEnablePDEV.

iFile

Identifie le fichier de police du pilote. Cette valeur est retournée par DrvLoadFontFile.

iFace

Spécifie l’index de base un de la police du pilote.

iMode

Spécifie le type d’informations à fournir. Il peut s’agir de l’une des valeurs suivantes :

Valeur Signification
QFT_GLYPHSET GDI demande un pointeur vers une structure FD_GLYPHSET qui définit les mappages des caractères Unicode uniques aux handles de glyphes.
QFT_KERNPAIRS GDI demande un pointeur vers un tableau trié et terminé par null de structures FD_KERNINGPAIR .

Les paires de crénage doivent être stockées dans l’ordre croissant. La clé primaire est le deuxième caractère Unicode ; la clé secondaire est le premier caractère Unicode de la paire de crénage.

pid

Pointeur vers un emplacement de mémoire contenant l’adresse d’une valeur définie par le pilote. GDI transmet le contenu de *pid à DrvFree, ainsi que le pointeur retourné, lorsque la structure FD_GLYPHSET ou le tableau de structures FD_KERNINGPAIR ne sont plus nécessaires. Selon la façon dont la mémoire est gérée dans le pilote, la valeur définie par le pilote peut identifier la structure, identifier la façon dont elle a été allouée ou ne rien faire du tout.

Valeur retournée

La valeur de retour est un pointeur vers la structure demandée si la fonction réussit. Sinon, il est NULL et un code d’erreur est journalisé.

Remarques

La structure retournée doit rester inchangée jusqu’à ce que GDI appelle DrvFree avec l’adresse de la structure.

DrvQueryFontTree est requis pour les pilotes de police et les pilotes qui utilisent des polices spécifiques au périphérique.

Configuration requise

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

Voir aussi

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS