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) |