FltAllocateExtraCreateParameterFromLookasideList 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltAllocateExtraCreateParameterFromLookasideList ルーチンは、追加の create パラメーター (ECP) コンテキスト構造用に特定のルックアサイドリストからメモリプールを割り当て、その構造体へのポインターを生成します。

構文

NTSTATUS FLTAPI FltAllocateExtraCreateParameterFromLookasideList(
  [in]           PFLT_FILTER                                    Filter,
  [in]           LPCGUID                                        EcpType,
  [in]           ULONG                                          SizeOfContext,
  [in]           FSRTL_ALLOCATE_ECP_FLAGS                       Flags,
  [in, optional] PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK CleanupCallback,
  [in, out]      PVOID                                          LookasideList,
  [out]          PVOID                                          *EcpContext
);

パラメーター

[in] Filter

ミニフィルタードライバーへの不透明なフィルターポインター。このポインターは、ミニフィルタードライバーを一意に識別し、ミニフィルタードライバーが読み込まれている限り一定のままになります。

[in] EcpType

ECP コンテキスト構造の型を示す GUID へのポインター。詳細については、「ドライバーでの GUID の使用」を参照してください。

[in] SizeOfContext

ECP コンテキスト構造のサイズ (バイト単位)。

[in] Flags

プール割り当てオプションを定義します。 SizeOfContext パラメーターの値が、指定されたルックアサイドリストのサイズ (バイト単位) よりも大きい場合、ECP コンテキスト構造はルックアサイドリストではなくシステムプールから割り当てられます。この場合、 Flags パラメーターに FSRTL_ALLOCATE_ECP_FLAG_CHARGE_QUOTA ビットフラグ値が含まれている場合、ルーチンによって割り当てられたシステムプールは、現在のプロセスのメモリクォータに対して課金されます。詳細については、FltAllocateExtraCreateParameter の Flags パラメーターを参照してください。 ECP コンテキスト構造のメモリがルックアサイドリストから割り当てられる場合、より一般的なケースでは、FSRTL_ALLOCATE_ECP_FLAG_CHARGE_QUOTA ビットフラグはルーチンで使用されません。

[in, optional] CleanupCallback

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK 型のミニフィルター定義クリーンアップコールバックルーチンへのオプションのポインター。クリーンアップコールバックルーチンは、ECP コンテキスト構造が削除されるときに呼び出されます。クリーンアップコールバックルーチンが適用されない場合は、このパラメーターを NULL に 設定します。

[in, out] LookasideList

(ECP コンテキスト構造の場合) からプールを割り当てようとする初期化されたルックアサイドリストへのポインター。ルックアサイドリストを初期化するには、 FltInitExtraCreateParameterLookasideList ルーチンを使用します。

[out] EcpContext

割り当てられた ECP コンテキスト構造へのポインターを受け取ります。ルーチンが ECP コンテキスト構造に十分なプールを割り当てなかった場合、 EcpContext は NULL になり、ルーチンは状態コード STATUS_INSUFFICIENT_RESOURCESを返します。

戻り値

FltAllocateExtraCreateParameterFromLookasideList ルーチンは、次のいずれかの値を返すことができます。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	FltAllocateExtraCreateParameterFromLookasideList ルーチンは、ECP コンテキスト構造に十分なメモリを割り当てることができませんでした。この場合、 EcpContext は NULL になります。
STATUS_SUCCESS	ECP コンテキスト構造が正常に割り当てられています。この場合、割り当てられた構造体へのポインターが EcpContext パラメーターによって返されます。

注釈

このルーチンは、Windows Vista 以降で使用できます。

FltAllocateExtraCreateParameterFromLookasideList ルーチンは、指定された初期化されたページまたはページ以外のルックアサイドリストから ECP コンテキスト構造のメモリプールを割り当てます。ただし、( SizeOfContext パラメーターで定義されている) ECP コンテキスト構造のサイズがルックアサイドリストよりも大きい場合、ルーチンは同様にページシステムプールまたは非ページシステムプールからメモリを割り当てます。

FltInitExtraCreateParameterLookasideList ルーチンを使用して、ページプールまたは非ページプールのルックアサイドリストを初期化します。検索側リストから ECP コンテキスト構造を割り当てるには FltAllocateExtraCreateParameterFromLookasideList ルーチンを使用し、ECP コンテキスト構造の割り当てを解除するには FltFreeExtraCreateParameter ルーチンを使用します。

ルックアサイドリストを解放するには、 FltDeleteExtraCreateParameterLookasideList ルーチンを使用します。

ドライバーは、アンロードする前に作成するすべての ECP コンテキスト構造とルックアサイドリストを解放する必要があります。ただし、ファイルシステムまたはファイルシステムフィルタードライバーが、IRP_MJ_CREATE要求の処理中に既存または新しく作成されたECP_LISTに ECP をアタッチすると、IRP が完了すると、この ECP が自動的にクリーンアップされます。その結果、フィルタードライバーは、動的に追加される ECP をクリーンする必要はありません。これにより、フィルタードライバーの ECP を再解析ポイント間で適切に伝達できます。つまり、複数のIRP_MJ_CREATE要求を生成する必要があるプロセスです。

ドライバーでルックアサイドリストを使用する方法の詳細については、「Lookaside Listsの使用」を参照してください。