Fonction DrvQueryFont (winddi.h)
La fonction DrvQueryFont est utilisée par GDI pour obtenir la structure IFIMETRICS pour une police donnée.
Syntaxe
PIFIMETRICS DrvQueryFont(
DHPDEV dhpdev,
ULONG_PTR iFile,
ULONG iFace,
ULONG_PTR *pid
);
Paramètres
dhpdev
Gérez le PDEV de l’appareil physique qui identifie un appareil physique. Le PDEV a été retourné à partir d’un appel précédent à DrvEnablePDEV.
iFile
Pointeur vers une valeur définie par le pilote qui identifie un fichier de police de pilote. Ce pointeur est retourné par DrvLoadFontFile. Ce paramètre est zéro pour les polices résidentes de l’appareil.
iFace
Spécifie l’index de base unique de la police du pilote. GDI peut interroger le nombre de polices à partir de la structure DEVINFO .
pid
Pointeur vers un emplacement de mémoire contenant l’adresse d’une valeur définie par le pilote que GDI transmet à DrvFree lorsque la structure IFIMETRICS n’est plus nécessaire. Selon la façon dont le pilote gère la mémoire, cette valeur 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 IFIMETRICS qui décrit la police donnée si la fonction réussit. Sinon, il est NULL et un code d’erreur est journalisé.
Remarques
Le pilote remplit la structure IFIMETRICS.
La structure IFIMETRICS doit rester inchangée pendant l’étendue du PDEV associé.
Si le nombre de polices dans DEVINFO est -1 et iFace est égal à zéro, le pilote doit retourner le nombre de polices qu’il prend en charge.
DrvQueryFont est requis pour les pilotes de police et les pilotes qui utilisent des polices spécifiques aux pilotes ou aux périphériques.
Configuration requise
Plateforme cible | Bureau |
En-tête | winddi.h (inclure Winddi.h) |