DrvFree 関数 (winddi.h)
DrvFree 関数は、指定した構造体が不要になったことをドライバーに通知するために使用されます。
構文
void DrvFree(
PVOID pv,
ULONG_PTR id
);
パラメーター
pv
メモリを解放する構造体へのポインター。
id
構造体で返された識別子へのポインター。
戻り値
なし
解説
DrvFree は、構造体に関連付けられているメモリを解放できる場合にドライバーに通知する必要がある場合にのみサポートする必要がある省略可能な関数です。 たとえば、 FONTOBJ 構造体が使用されている場合、 削除は DrvDestroyFont が呼び出されるまで延期できるため、ドライバーが DrvFree を実装する必要がなくなります。
ドライバーでは、さまざまな方法で ID を 使用できます。 オブジェクト ハンドルを指定することも、構造体の割り当て方法を示すこともできます。 たとえば、読み込まれたリソースとヒープから割り当てられたメモリを区別できます。 pv が指す構造体に十分な情報が含まれている場合、ドライバーはこのパラメーターを無視できます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | winddi.h (Winddi.h を含む) |