Funzione di callback PFNGETINFO (printoem.h)

Articolo
02/26/2024

La funzione di callback UNIFONTOBJ_GetInfo viene fornita dal driver Unidrv in modo che i plug-in di rendering possano ottenere informazioni sul tipo di carattere o sul glifo.

Sintassi

PFNGETINFO Pfngetinfo;

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

Parametri

unnamedParam1

Puntatore alla struttura UNIFONTOBJ ricevuta dalla funzione che esegue il callback in UNIFONTOBJ_GetInfo. Fornito dal chiamante.

unnamedParam2

Specifica le dimensioni, in byte, del buffer a cui fa riferimento pData. Fornito dal chiamante.

unnamedParam3

Puntatore a una struttura, come indicato nella tabella seguente. Fornito dal chiamante.

Valore dwInfoID	pData Struttura
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

Per altre informazioni, vedere la tabella nella sezione Osservazioni .

unnamedParam4

Specifica il tipo di struttura a cui fa riferimento pData. Fornito dal chiamante. Per altre informazioni, vedere la tabella nella sezione Osservazioni .

unnamedParam5

Puntatore a una posizione che riceve le dimensioni minime del buffer, in byte, necessarie per contenere la struttura identificata da dwInfoID. Fornito dal chiamante.

Valore restituito

Restituisce un valore BOOL . Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE.

Commenti

La funzione di callback UNIFONTOBJ_GetInfo consente a un plug-in di rendering di richiamare un plug-in Unidrv per ottenere informazioni sul tipo di carattere o sul glifo da GDI, necessarie per gestire le operazioni di gestione dei tipi di carattere personalizzate .

Un plug-in di rendering riceve l'indirizzo della funzione UNIFONTOBJ_GetInfo nella struttura UNIFONTOBJ passata ai metodi di personalizzazione dei tipi di carattere.

Il tipo di informazioni restituite dalla funzione dipende dagli argomenti di input. Il chiamante fornisce valori per dwInfoID, pData e dwDataSize per indicare il tipo di informazioni desiderate. Nella tabella seguente vengono riepilogati i tipi di informazioni restituite. Per altre informazioni, vedere le descrizioni della struttura.

pData Struttura	Informazioni restituite
GETINFO_FONTOBJ	Struttura FONTOBJ che descrive il carattere corrente.
GETINFO_GLYPHBITMAP	Una singola bitmap del glifo.
GETINFO_GLYPHSTRING	Matrice di identificatori glifi in un formato specificato.
GETINFO_GLYPHWIDTH	Larghezza totale di un set di glifi.
GETINFO_MEMORY	Quantità di memoria della stampante disponibile rimanente.
GETINFO_STDVAR	Valore corrente per una o più variabili standard di Unidrv.

Se il buffer descritto da pData e dwDataSize è troppo piccolo per ricevere la struttura indicata da dwInfoID, la funzione carica le dimensioni del buffer necessarie nella posizione puntata da pcbNeed e restituisce FALSE.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	printoem.h (include Printoem.h)

Condividi tramite