Win32 API 日本語リファレンス
ホーム › Devices.Display › PFN_DrvDestroyFont

PFN_DrvDestroyFont

コールバック

シグネチャ

void PFN_DrvDestroyFont(
    FONTOBJ* param0
);

パラメーター

フィールド型
param0FONTOBJ*

公式ドキュメント

DrvDestroyFont 関数は、フォントの実現体がもはや必要なくなり、ドライバーが割り当てた関連データ構造を解放できるようになったことをドライバーに通知します。

解説(Remarks)

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

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

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

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

GDI は、DrvDestroyFont と DrvTextOut が決して重複しないことを保証します。そのため、ドライバーは DrvTextOut の呼び出しを処理する間、キャッシュした情報に依存できます。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)