共用方式為


FONTOBJ_cGetGlyphs函式 (winddi.h)

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

另請參閱

DrvGetGlyphMode

FONTOBJ

FONTOBJ_cGetAllGlyphHandles

GLYPHBITS

IFIMETRICS

PATHOBJ