DrvFree 関数 (winddi.h)

[アーティクル]
03/04/2024

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

構文

void DrvFree(
  PVOID     pv,
  ULONG_PTR id
);

パラメーター

pv

メモリを解放する構造体へのポインター。

id

構造体で返された識別子へのポインター。

戻り値

なし

解説

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

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