Funzione DrvQueryFontTree (winddi.h)

Articolo
03/13/2024

La funzione DrvQueryFontTree fornisce GDI con un puntatore a una struttura che definisce uno dei seguenti elementi:

Mapping da unicode a handle del glifo, incluse le varianti del glifo
Mapping di coppie di kerning a handle di kerning

Sintassi

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

Parametri

dhpdev

Identifica un dispositivo da un handle al relativo PDEV, restituito da una chiamata precedente a DrvEnablePDEV.

iFile

Identifica il file di carattere del driver. Questo valore viene restituito da DrvLoadFontFile.

iFace

Specifica l'indice in base uno del tipo di carattere del driver.

iMode

Specifica il tipo di informazioni da specificare. I valori possibili sono i seguenti:

Valore	Significato
QFT_GLYPHSET	GDI richiede un puntatore a una struttura FD_GLYPHSET che definisce i mapping da singoli caratteri Unicode agli handle del glifo.
QFT_KERNPAIRS	GDI richiede un puntatore a una matrice con terminazione null ordinata di strutture FD_KERNINGPAIR . Le coppie di kerning devono essere archiviate in ordine crescente. La chiave primaria è il secondo carattere Unicode; la chiave secondaria è il primo carattere Unicode nella coppia di kerning.

pid

Puntatore a una posizione di memoria che contiene l'indirizzo di un valore definito dal driver. GDI passa il contenuto di *pid a DrvFree, insieme al puntatore restituito, quando la struttura FD_GLYPHSET o la matrice di strutture FD_KERNINGPAIR non sono più necessarie. A seconda della modalità di gestione della memoria nel driver, il valore definito dal driver può identificare la struttura, identificare il modo in cui è stato allocato o non eseguire nulla.

Valore restituito

Il valore restituito è un puntatore alla struttura richiesta se la funzione ha esito positivo. In caso contrario, è NULL e viene registrato un codice di errore.