Funzione DrvQueryFontTree (winddi.h)
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.
Commenti
La struttura restituita deve rimanere invariata fino a quando GDI chiama DrvFree con l'indirizzo della struttura.
DrvQueryFontTree è necessario per i driver e i driver dei tipi di carattere che usano tipi di carattere specifici del dispositivo.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | winddi.h (include Winddi.h) |