PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK コールバック関数 (ntifs.h)

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

フィルタードライバーは、追加の create パラメーター (ECP) コンテキスト構造のフィルタードライバーの CleanupCallback コールバックルーチンとして、PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK型のルーチンを登録できます。

構文

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

パラメーター

[in, out] EcpContext

ECP コンテキスト構造を割り当てたルーチンによって返された ECP コンテキストポインター。

[in[] EcpType

追加の create パラメーター型を示す、ECP コンテキスト構造を割り当てたルーチンに渡された GUID へのポインター。詳細については、「ドライバーでの GUID の使用」を参照してください。

戻り値

なし

解説

フィルタードライバーは、ECP コンテキスト構造を割り当てるときに、必要に応じて、フィルタードライバーの CleanupCallback コールバックルーチンとしてPFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK型指定されたルーチンを指定できます。フィルタードライバーで CleanupCallback コールバックルーチンが指定されている場合、オペレーティングシステムは (IRQ レベルに関係なく) CleanupCallback ルーチンを 呼び出します。この CleanupCallback ルーチンは、ECP コンテキスト構造が削除されたときに、必要な ECP コンテキスト関連のクリーンアップ処理を実行します。

コールバックルーチンを指定するために、フィルタードライバーは、最初に ECP コンテキスト構造を割り当てたルーチンの CleanupCallback パラメーターを使用して、コールバックルーチンへのポインターを渡します。コールバックルーチンが必要ない場合は、CLEANUPCallback パラメーターに NULL 値を渡す必要があります。

次のルーチンは、PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK型指定のコールバックルーチンをサポートしています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	デスクトップ
Header	ntifs.h (Ntifs.h、FltKernel.h を含む)
IRQL	PASSIVE_LEVEL