Funzione di callback PFNGETINFO (printoem.h)

  • Articolo

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)