PFN_DrvFree

コールバック

シグネチャ

void PFN_DrvFree(
    void* param0,
    UINT_PTR param1
);

パラメーター

フィールド	型
param0	void*
param1	UINT_PTR

公式ドキュメント

DrvFree 関数は、指定された構造体がもう必要でなくなったことをドライバーに通知するために使用されます。

解説(Remarks)

DrvFree は省略可能な関数であり、構造体に関連付けられたメモリを解放できるタイミングをドライバーに知らせる必要がある場合にのみサポートします。たとえば、FONTOBJ 構造体が使用中の場合は、DrvDestroyFont が呼び出されるまで削除を遅延させることができるため、ドライバーが DrvFree を実装する必要はなくなります。

ドライバーは id をさまざまな用途に使用できます。オブジェクトのハンドルを指定することも、構造体の割り当て方法を示すこともできます。たとえば、読み込まれたリソースとヒープから割り当てられたメモリを区別できます。pv が指す構造体に十分な情報が含まれている場合、ドライバーはこのパラメーターを無視できます。

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