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 を含む) |