Fonction de rappel PFNGETINFO (printoem.h)

Article
02/07/2025

La fonction de rappel UNIFONTOBJ_GetInfo est fournie par le pilote Unidrv afin que les plug-ins de rendu puissent obtenir des informations de police ou de glyphe.

Syntaxe

PFNGETINFO Pfngetinfo;

BOOL Pfngetinfo(
  _UNIFONTOBJ *unnamedParam1,
  DWORD unnamedParam2,
  PVOID unnamedParam3,
  DWORD unnamedParam4,
  PDWORD unnamedParam5
)
{...}

Paramètres

unnamedParam1

Pointeur vers la structure UNIFONTOBJ reçue par la fonction qui effectue le rappel vers UNIFONTOBJ_GetInfo. Fourni par l’appelant.

unnamedParam2

Spécifie la taille, en octets, de la mémoire tampon pointée par pData. Fourni par l’appelant.

unnamedParam3

Pointeur vers une structure, comme indiqué dans le tableau suivant. Fourni par l’appelant.

valeur dwInfoID	structure pData
UFO_GETINFO_FONTOBJ	GETINFO_FONTOBJ
UFO_GETINFO_GLYPHBITMAP	GETINFO_GLYPHBITMAP
UFO_GETINFO_GLYPHSTRING	GETINFO_GLYPHSTRING
UFO_GETINFO_GLYPHWIDTH	GETINFO_GLYPHWIDTH
UFO_GETINFO_MEMORY	GETINFO_MEMORY
UFO_GETINFO_STDVARIABLE	GETINFO_STDVAR

Pour plus d’informations, consultez le tableau de la section remarques.

unnamedParam4

Spécifie le type de structure pointé par pData. Fourni par l’appelant. Pour plus d’informations, consultez le tableau de la section remarques.

unnamedParam5

Pointeur vers un emplacement qui reçoit la taille minimale de la mémoire tampon, en octets, nécessaire pour contenir la structure identifiée par dwInfoID. Fourni par l’appelant.

Valeur de retour

Retourne une valeur BOOL. Si l’opération réussit, la fonction retourne TRUE. Sinon, elle retourne FALSE.

Remarques

La fonction de rappel UNIFONTOBJ_GetInfo permet à un plug-in de rendu de de rendre un rappel à Unidrv pour obtenir des informations de police ou de glyphe à partir de GDI, nécessaires à la gestion des opérations personnalisées de gestion des polices.

Un plug-in de rendu reçoit l’adresse de la fonction UNIFONTOBJ_GetInfo dans la structure UNIFONTOBJ transmise aux méthodes de personnalisation de police.

Le type d’informations retournées par la fonction dépend des arguments d’entrée. L’appelant fournit des valeurs pour dwInfoID, pDataet dwDataSize pour indiquer le type d’informations souhaité. Le tableau suivant récapitule les types d’informations retournées. Pour plus d’informations, consultez les descriptions de structure.

structure pData	Informations retournées
GETINFO_FONTOBJ	Structure FONTOBJ décrivant la police actuelle.
GETINFO_GLYPHBITMAP	Image bitmap de glyphe unique.
GETINFO_GLYPHSTRING	Tableau de spécificateurs de glyphes dans un format spécifié.
GETINFO_GLYPHWIDTH	Largeur totale d’un ensemble de glyphes.
GETINFO_MEMORY	Quantité de mémoire d’imprimante disponible restante.
GETINFO_STDVAR	Valeur actuelle pour une ou plusieurs variables standard Unidrv.

Si la mémoire tampon décrite par pData et dwDataSize est trop petite pour recevoir la structure indiquée par dwInfoID, la fonction charge la taille de la mémoire tampon requise dans l’emplacement indiqué par de tableaux de mémoire tampon et retourne FAUX.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	printoem.h (include Printoem.h)

Partager via