drvQueryFontTree 函式 (winddi.h)
DrvQueryFontTree 函式會提供 GDI 的指標，指向定義下列其中一項的結構：
- 從 Unicode 到字元句柄的對應，包括字元變體
- Kerning 配對與 Kerning 句柄的對應
語法
PVOID DrvQueryFontTree(
DHPDEV dhpdev,
ULONG_PTR iFile,
ULONG iFace,
ULONG iMode,
ULONG_PTR *pid
);
參數
dhpdev
透過其 PDEV 的句柄識別裝置，該裝置是從 先前呼叫DrvEnablePDEV傳回的。
iFile
識別驅動程式字型檔案。 這個值是由 DrvLoadFontFile傳回。
iFace
指定驅動程式字型的單一索引。
iMode
指定要提供的資訊類型。 這個值可以是下列其中一個值：
| 值 | 意義 |
|---|---|
| QFT_GLYPHSET | GDI 會要求 指向FD_GLYPHSET 結構的指標，以定義從單一 Unicode 字元到字元句柄的對應。 |
| QFT_KERNPAIRS |
GDI 要求指向已排序、以 Null 結束 的陣列FD_KERNINGPAIR 結構的指標。
kerning 配對應該以遞增順序儲存。 主鍵是第二個 Unicode 字元;次要機碼是 kerning 配對中的第一個 Unicode 字元。 |
pid
存放驅動程式定義值位址的記憶體位置指標。 當不再需要FD_KERNINGPAIR結構的FD_GLYPHSET結構或陣列時，GDI 會將 *pid 的內容傳遞至 DrvFree以及傳回的指標。 根據驅動程式中的記憶體管理方式，驅動程式定義的值可以識別結構、識別配置的方式，或完全不執行任何動作。
傳回值
如果函式成功，傳回值是要求結構的指標。 否則為 NULL，並記錄錯誤碼。
備註
傳回的結構必須保持未修改狀態，直到 GDI 使用 結構的位址呼叫 DrvFree 為止。
使用裝置特定字型的字型驅動程式和驅動程式需要DrvQueryFontTree。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winddi.h (包含Winddi.h) |