FONTOBJ_cGetGlyphs関数 (winddi.h)

[アーティクル]
08/27/2023

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 フラグが設定されている場合は、パスをストロークする必要があります。それ以外の場合は、パスを入力する必要があります。

値

意味

FO_GLYPHBITS

データは、グリフのビットマップを定義する GLYPHBITS 構造体で構成されます。

FO_PATHOBJ

データは、グリフのアウトラインを定義する PATHOBJ 構造体で構成されます。

パスを塗りつぶすかストロークするかを判断するには、フォントコンシューマーが IFIMETRICS 構造体の flInfo メンバーをチェックする必要があります。 FM_INFO_RETURNS_STROKES フラグが設定されている場合は、パスをストロークする必要があります。それ以外の場合は、パスを入力する必要があります。

cGlyph

変換するグリフの数を指定します。許容される値は 1 のみです (指定された値に関係なく、コードは 1 を前提としています)。

phg

ドライバーによって提供される cGlyph HGLYPH 構造体の配列へのポインター。

ppvGlyph

GLYPHDATA 構造体のアドレスを受け取るメモリ位置へのポインター。この構造体の最初のメンバーは GLYPHDEF 共用体です。この共用体には、 iMode パラメーターの値に応じて GLYPHBITS 構造体または PATHOBJ 構造体へのポインターが含まれます。 iMode の値がFO_GLYPHBITSの場合、(ppvGlyph)->gdf には GLYPHBITS 構造体のアドレスが含まれます。iMode の値がFO_PATHOBJの場合、(ppvGlyph)->gdf には PATHOBJ 構造体のアドレスが含まれます。

戻り値

戻り値は、関数が成功した場合にドライバーに渡されるポインターの数です。それ以外の場合は 0 になり、エラーコードがログに記録されます。

注釈

ドライバーがフォントをキャッシュしている場合は、この関数を使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	winddi.h (Winddi.h を含む)
Library	Win32k.lib
[DLL]	Win32k.sys