FONTOBJ_cGetGlyphs函式 (winddi.h)

發行項
03/13/2024

FONTOBJ_cGetGlyphs函式是字型取用者的一項服務，可將字元句柄轉譯為圖像數據的指標，直到下一次呼叫FONTOBJ_cGetGlyphs為止。

語法

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

參數

pfo

FONTOBJ 結構的指標，其中包含要翻譯的字元句柄。

[in] iMode

指定數據是否會寫入為位圖或大綱物件。此參數可以是下列其中一個值：

值	意義
FO_GLYPHBITS	數據將包含定義字元位圖的 GLYPHBITS 結構。
FO_PATHOBJ	數據將包含 PATHOBJ 結構，這些結構會定義字元的大綱。若要判斷路徑是否應該填滿或筆劃，字型取用者應該檢查IFIMETRICS結構的 flInfo 成員。如果已設定FM_INFO_RETURNS_STROKES旗標，則應該筆劃路徑;否則，應該填入路徑。

cGlyph

指定要翻譯的字元數目。程式代碼假設 (唯一可接受的值為 1，不論指定的值) 為何。

phg

驅動程式所提供 cGlyph HGLYPH 結構的數位指標。

ppvGlyph

接收 GLYPHDATA 結構地址的記憶體位置指標。這個結構的第一個成員是 GLYPHDEF 等位，其包含 GLYPHBITS 結構或 PATHOBJ 結構的指標，視 iMode 參數的值而定。如果 iMode 的值FO_GLYPHBITS， (ppvGlyph) ->gdf 包含 GLYPHBITS 結構的位址。如果 iMode 的值是FO_PATHOBJ， (ppvGlyph) -gdf> 包含 PATHOBJ 結構的位址。

傳回值

如果函式成功，傳回值就是傳遞至驅動程式的指標計數。否則，它會是零，而且會記錄錯誤碼。

備註

如果驅動程式正在快取字型，就應該使用此函式。

規格需求

需求	值
最低支援的用戶端	可在 Windows 2000 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	winddi.h (包括 Winddi.h)
程式庫	Win32k.lib
Dll	Win32k.sys