DrvQueryFontTree 関数 (winddi.h)

DrvQueryFontTree 関数は、次のいずれかを定義する構造体へのポインターを GDI に提供します。

  • Unicode からグリフ ハンドルへのマッピング (グリフバリアントを含む)
  • カーニング ハンドルへのカーニング ペアのマッピング

構文

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

パラメーター

dhpdev

DrvEnablePDEV の以前の呼び出しから返される、PDEV へのハンドルによってデバイスを識別します。

iFile

ドライバー フォント ファイルを識別します。 この値は 、DrvLoadFontFile によって返されます。

iFace

ドライバー フォントの 1 から始まるインデックスを指定します。

iMode

指定する情報の種類を指定します。 次のいずれかの値を指定できます。

意味
QFT_GLYPHSET GDI は、1 つの Unicode 文字からグリフ ハンドルへのマッピングを定義する FD_GLYPHSET 構造体へのポインターを要求します。
QFT_KERNPAIRS GDI は、 FD_KERNINGPAIR構造体の 並べ替えられた null で終わる配列へのポインターを要求します。

カーニング ペアは、順序を増やして格納する必要があります。 主キーは 2 番目の Unicode 文字です。セカンダリ キーは、カーニング ペアの最初の Unicode 文字です。

pid

ドライバー定義値のアドレスを保持するメモリ位置へのポインター。 GDI は、FD_GLYPHSET構造体またはFD_KERNINGPAIR構造体の配列が不要になったときに、返されたポインターと共に *pid の内容を DrvFree に渡します。 ドライバーでメモリを管理する方法に応じて、ドライバーで定義された値は、構造体を識別したり、割り当て方法を識別したり、まったく何も行ったりできません。

戻り値

戻り値は、関数が成功した場合に要求された構造体へのポインターです。 それ以外の場合は NULL になり、エラー コードがログに記録されます。

注釈

GDI が 構造体のアドレスを使用して DrvFree を呼び出すまで、返される構造体は変更されません。

DrvQueryFontTree は、デバイス固有のフォントを使用するフォント ドライバーとドライバーに必要です。

要件

要件
対象プラットフォーム デスクトップ
Header winddi.h (Winddi.h を含む)

こちらもご覧ください

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS