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)

Vedi anche

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS