DrvDestroyFont 関数 (winddi.h)

  • [アーティクル]

DrvDestroyFont 関数は、フォントの実現が不要になったこと、およびドライバーが割り当てた関連付けられているデータ構造を解放できるようになったことをドライバーに通知します。

構文

void DrvDestroyFont(
  FONTOBJ *pfo
);

パラメーター

pfo

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

戻り値

なし

解説

DrvDestroyFont 関数は、フォント ドライバーとカーネル モード プリンター ドライバーでのみ呼び出されます。

DEVICE_FONTTYPE フラグが FONTOBJ 構造体の flFontType メンバーに設定されている場合、ドライバーは、FONTOBJ の pvConsumer メンバーと pvProducer メンバーの両方で識別されたリソースまたはメモリを解放する必要があります。 それ以外の場合は、 pvConsumer で識別されたメモリとリソースのみを解放する必要があります。

ドライバーは、 pvConsumer メンバーと pvProducer メンバーを使用する場合は NULL にリセットする必要があります。

GDI は、フォント プロデューサーに対して DrvDestroyFont を 1 回呼び出し、フォント コンシューマーに対してもう一度呼び出します。

GDI では 、DrvDestroyFont と DrvTextOut が重複しないことが保証されます。その結果、ドライバーは DrvTextOut 呼び出しの処理中にキャッシュされた情報に依存できます。

フォント ドライバーまたはカーネル モード プリンター ドライバーがフォントを実現するときにリソースを割り当てる場合は、この関数を実装する必要があります。

要件

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

関連項目

DrvTextOut

FONTOBJ