DrvGetGlyphMode 関数 (winddi.h)

[アーティクル]
03/13/2024

DrvGetGlyphMode 関数は、グリフ情報をキャッシュする方法を GDI に指示します。

構文

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

パラメーター

[in] unnamedParam1

物理デバイスの PDEV 構造体を処理します。

[in] unnamedParam2

フォントサイズ、変換、およびその他のフォント属性を検索するためにクエリを実行できる FONTOBJ 構造体へのポインター。

戻り値

DrvGetGlyphMode は 、次のいずれかの値を返します。

リターンコード	説明
FO_GLYPHBITS	GDI では、このフォントのすべてのグリフデータをキャッシュする必要があります。
FO_HGLYPHS	デバイスは独自にフォントをキャッシュするため、GDI はこのフォントのグリフハンドルのみをキャッシュする必要があります。
FO_PATHOBJ	GDI では、このフォントの PATHOBJ 構造体をキャッシュする必要があります。

注釈

GDI は、ドライバーの DrvGetGlyphMode ルーチンを呼び出して、特定のフォントに対してキャッシュする必要があるフォント情報の範囲を決定します。つまり、 DrvGetGlyphMode は、フォントキャッシュに格納される GDI を決定します。フォントを独自にキャッシュするデバイスは、フォントのストレージ要件を最小限に抑えるために、FO_HGLYPHSを返す必要があります。

GDI は、フォントの実現ごとに DrvGetGlyphMode を呼び出します。たとえば、ドライバーは、12 ポイントより大きいポイントサイズのアウトラインをダウンロードし、小さいフォントのラスターイメージをダウンロードする場合があります。ただし、GDI は、この要求を拒否する権利を留保します。

ドライバーは、グリフの実際の形式を決定するために、FONTOBJ 構造体の flFontType メンバーのRASTER_FONTTYPE ビットをチェックする必要があります。このビットが設定されている場合、GDI はビットマップを送信します。それ以外の場合は、PATHOBJ 構造体を送信しています。

DrvGetGlyphMode の呼び出し時に、関連付けられている FONTOBJ は完全には機能しません。 GDI では、 IFIMETRICS 構造体と概念からデバイスへの変換が正しいことのみが保証されます。

DrvGetGlyphMode は省略可能なドライバー関数です。この関数が指定されていない場合、GDI は既定でラスターフォントを格納します。