次の方法で共有

FREE_FUNCTION_EX コールバック関数 (wdm.h)

  • [アーティクル]

LookasideListFreeEx ルーチンは、クライアントが完全なルックアサイド リストにエントリを挿入しようとしたときに、ルックアサイド リスト エントリのストレージを解放します。

構文

FREE_FUNCTION_EX FreeFunctionEx;

void FreeFunctionEx(
  [in]      PVOID Buffer,
  [in, out] PLOOKASIDE_LIST_EX Lookaside
)
{...}

パラメーター

[in] Buffer

解放されるルックアサイド リスト エントリへのポインター。

[in, out] Lookaside

ルックアサイド リストを記述する LOOKASIDE_LIST_EX 構造体へのポインター。 この構造体は、以前は exInitializeLookasideListEx ルーチン によって初期化されていました。

戻り値

何一つ

備考

ルックアサイド リストを作成するドライバーは、LookasideListFreeEx ルーチンを実装して、リストがいっぱいになり、それ以上バッファーを含めなくなったときに、以前に割り当てられたバッファーを解放できます。 使用されていないバッファーは、リスト内のエントリとして格納されます。 ルックアサイド リスト内のすべてのエントリは、一覧が初期化されるタイミングをドライバーが指定する、均一サイズのバッファーです。

ドライバーは、ルックアサイド リストを初期化する ExInitializeLookasideListEx 呼び出しの入力パラメーターとして、カスタム LookasideListFreeEx ルーチンへのポインターを提供します。 ドライバーが NULL このパラメーターを設定する場合、ルックアサイド リストは代わりに既定の割り当て解除ルーチンを使用します。

ドライバーは、ExFreeToLookasideListEx ルーチンを呼び出して、以前に割り当てられたエントリをルックアサイド リストに挿入します。 リストがいっぱいの場合 (つまり、リストにシステムによって決定されたエントリの最大数が既に含まれている場合)、ExFreeToLookasideListEx は LookasideListFreeEx 呼び出して、エントリのストレージを解放します。

LookasideListFreeEx ルーチンは、Lookaside パラメーターを使用して、ドライバーがルックアサイド リストに関連付けられているプライベート コンテキスト データにアクセスできます。 詳細については、exInitializeLookasideListEx のコード例を参照してください。

ルックアサイド リストの詳細については、「ルックアサイド リストの使用 を参照してください。

LookasideListFreeEx ルーチンは、エントリを解放する ExFreeToLookasideListEx 呼び出しと同じ IRQL で呼び出されます。 ページング されたメモリに存在するエントリを解放する呼び出しでは、呼び出し元が IRQL <= APC_LEVELを実行している必要があります。 非ページ メモリに存在するエントリを解放する呼び出しでは、呼び出し元が IRQL <= DISPATCH_LEVELを実行している必要があります。

例

LookasideListFreeEx コールバック ルーチン を定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。

たとえば、MyLookasideListFreeExという名前の LookasideListFreeEx コールバック ルーチンを定義するには、次のコード例に示すようにFREE_FUNCTION_EX型を使用します。

FREE_FUNCTION_EX MyLookasideListFreeEx;

次に、次のようにコールバック ルーチンを実装します。

_Use_decl_annotations_
VOID
  MyLookasideListFreeEx(
    PVOID  Buffer,
    PLOOKASIDE_LIST_EX  Lookaside
    )
  {
      // Function body
  }

FREE_FUNCTION_EX関数の種類は、Wdm.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、_Use_decl_annotations_ 注釈を関数定義に追加してください。 _Use_decl_annotations_ 注釈を使用すると、ヘッダー ファイル内のFREE_FUNCTION_EX関数型に適用される注釈が使用されます。 関数宣言の要件の詳細については、「WDM ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。 _Use_decl_annotations_の詳細については、「関数の動作 に注釈を付けるを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL 「解説」セクションを参照してください。

関連項目

ExFreeToLookasideListEx の

ExInitializeLookasideListEx の

LOOKASIDE_LIST_EX