Fonction de rappel PFNGETINFO (printoem.h)

Article
02/26/2024

La fonction de rappel UNIFONTOBJ_GetInfo est fournie par le pilote Unidrv afin que les plug-ins de rendu puissent obtenir des informations sur la police ou le 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 à 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.

dwInfoID Value	Pdata Structure
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é vers 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 mémoire tampon, en octets, requise pour contenir la structure identifiée par dwInfoID. Fourni par l’appelant.

Valeur retournée

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

Remarques

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

Un plug-in de rendu reçoit l’adresse de la fonction UNIFONTOBJ_GetInfo dans la structure UNIFONTOBJ qui est passée 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, pData et dwDataSize pour indiquer le type d’informations souhaitées. Le tableau suivant récapitule les types d’informations retournées. Pour plus d’informations, consultez les descriptions de structure.

Pdata Structure	Informations retournées
GETINFO_FONTOBJ	Structure FONTOBJ décrivant la police actuelle.
GETINFO_GLYPHBITMAP	Une 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 d’une ou plusieurs variables standard d’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 mémoire tampon requise dans l’emplacement pointé par pcbNeeded et retourne FALSE.

Configuration requise

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

Partager via