FltAllocateExtraCreateParameterList 関数 (fltkernel.h)

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

FltAllocateExtraCreateParameterList ルーチンは、追加の create パラメーター (ECP) リスト構造にページプールメモリを割り当て、その構造体へのポインターを生成します。

構文

NTSTATUS FLTAPI FltAllocateExtraCreateParameterList(
  [in]  PFLT_FILTER                  Filter,
  [in]  FSRTL_ALLOCATE_ECPLIST_FLAGS Flags,
  [out] PECP_LIST                    *EcpList
);

パラメーター

[in] Filter

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

[in] Flags

プール割り当てオプションを定義します。ビットごとの OR 操作を使用してFSRTL_ALLOCATE_ECPLIST_FLAG_CHARGE_QUOTA フラグを Flags パラメーターと組み合わせると、ルーチンによって割り当てられたプールは、現在のプロセスのメモリクォータに対して課金されます。

[out] EcpList

初期化された ECP リスト構造体へのポインターを受け取ります。ルーチンが十分なプールの割り当てに失敗した場合、 *EcpList は NULL になり、ルーチンは状態コードSTATUS_INSUFFICIENT_RESOURCESを返します。

戻り値

FltAllocateExtraCreateParameterList は、次のいずれかの値を返すことができます。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	FltAllocateExtraCreateParameterList が ECP リスト構造に十分なメモリを割り当てることができませんでした。この場合、 EcpList は NULL* になります。
STATUS_SUCCESS	ECP リスト構造が正常に割り当てられ、初期化されました。この場合、初期化されたリスト構造へのポインターが *EcpList パラメーターで返されます。

注釈

FltAllocateExtraCreateParameterList が割り当てるメモリをオペレーティングシステムが自動的に解放するかどうかは、次の状況に示すように、FltAllocateExtraCreateParameterList が呼び出されるタイミングによって異なります。

呼び出し元は FltAllocateExtraCreateParameterList を呼び出してECP_LISTを割り当て、呼び出し元が FltCreateFileEx2 ルーチンを呼び出す前に 1 つ以上の ECP コンテキスト構造を追加できます。この状況では、オペレーティングシステムは ECP コンテキスト構造を解放しません。したがって、呼び出し元は、同じ ECP セットを使用して FltCreateFileEx2 を複数呼び出すことができます。呼び出し元がECP_LISTで完了したら、呼び出し元は FltFreeExtraCreateParameterList ルーチンを呼び出して、ECP_LISTを解放する必要があります。
ファイルシステムフィルタードライバーが IRP_MJ_CREATE 要求を処理している間、ファイルシステムフィルタードライバーは FltInsertExtraCreateParameter を呼び出して、ECP を既存のECP_LISTにアタッチできます。 ECP_LISTが存在しない場合、呼び出し元は FltAllocateExtraCreateParameterList を呼び出してECP_LISTを作成する必要があります。このような状況では、作成操作が完了すると、ECP_LISTと ECP コンテキスト構造が I/O マネージャーによって自動的にクリーンアップされます。これにより、フィルタードライバーの ECP を再解析ポイントの処理全体に適切に伝達できます。このプロセスでは、複数のIRP_MJ_CREATE要求を生成する必要がある場合があります。

前述のように、FSRTL_ALLOCATE_ECPLIST_FLAG_CHARGE_QUOTA フラグを Flags パラメーターと共に使用すると、通常のページング可能プールが割り当てられます。それ以外の場合は、内部ルックアサイドリストを使用してページング可能なプールが割り当てられます。

ECP_LIST構造体

ECP_LISTは、オペレーティングシステムによって宣言される不透明な構造です。 ECP_LISTには、追加の create パラメーター (ECP) エントリの一覧が含まれています。

fltAllocateExtraCreateParameterList ルーチンを使用して、ECP_LIST構造体のメモリを割り当てる必要があります。 FltAllocateExtraCreateParameterList によって割り当てられたメモリは、オペレーティングシステムによって自動的に解放されません。FltFreeExtraCreateParameterList ルーチンを呼び出して、明示的に割り当てを解除する必要があります。 FltFreeExtraCreateParameterList が呼び出されると、残りの ECP リスト要素はすべて自動的に解放されることに注意してください。

PECP_LISTデータ型は、ECP_LIST型の変数へのポインターを宣言するために使用されます。

構文

struct ECP_LIST {
  ;      // Reserved.
};

ECP_LIST構造体は Ntifs.h で宣言されています (Ntifs.h を含む)。

要件

要件	値
サポートされている最小のクライアント	このルーチンは、Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
IRQL	<= APC_LEVEL