Partager via


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)

Voir aussi

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

IFIMETRICS