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)

另請參閱

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS