DrvQueryAdvanceWidths 関数 (winddi.h)

  • [アーティクル]

DrvQueryAdvanceWidths 関数は、指定したグリフのセットの文字の進み幅を返します。

構文

BOOL DrvQueryAdvanceWidths(
        DHPDEV  dhpdev,
        FONTOBJ *pfo,
        ULONG   iMode,
  [in]  HGLYPH  *phg,
  [out] PVOID   pvWidths,
        ULONG   cGlyphs
);

パラメーター

dhpdev

DrvEnablePDEV によって以前に返された物理デバイスの PDEV を処理します。

pfo

フォント インスタンスを識別する FONTOBJ 構造体へのポインター。

iMode

指定する情報の種類を指定します。 このパラメーターには、次のいずれかの値を指定できます。

値 説明
QAW_GETEASYWIDTHS 文字の進み幅は、12.4 個の固定小数点番号の配列として返されます。 幅が 12.4 表現の範囲を超える場合、このモードは使用されません。 このルーチンでは、幅を可能な限り迅速に計算する必要があります。 グリフの文字の進み幅の計算を効率的に実行できない場合、ドライバーはそのグリフのバッファーに0xFFFFを書き込む必要があります。 この関数は、エラーが発生した場合はDDI_ERRORを返し、このモードではすべての幅を効率的に計算できない場合は FALSE 、それ以外のすべての場合は TRUE を 返します。
QAW_GETWIDTHS 文字の進み幅は、12.4 個の固定小数点番号の配列として記録されます。 幅が 12.4 表現の範囲を超える場合、このモードは使用されません。 成功した場合、関数は TRUE を 返します。

[in] phg

ドライバーが文字の進み幅を返すグリフを指定するグリフ ハンドルの配列へのポインター。

[out] pvWidths

ドライバーがデータを記録するバッファーへのポインター。

cGlyphs

phg が指す入力バッファー内のグリフの数を指定します。

戻り値

戻り値は、 iMode パラメーターの値に依存します。

要件

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

関連項目

DrvEnablePDEV

FONTOBJ