FltGetEcpListFromCallbackData 関数 (fltkernel.h)

[アーティクル]
02/26/2024

FltGetEcpListFromCallbackData ルーチンは、指定された作成操作 callback-data オブジェクトに関連付けられている追加の create パラメーターコンテキスト構造 (ECP) リストへのポインターを返します。

構文

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

パラメーター

[in] Filter

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

CallbackData

作成操作を表す 、FLT_CALLBACK_DATA型のコールバックデータオブジェクトへのポインター。

[out] EcpList

CallbackData callback-data オブジェクトに関連付けられている ECP リストへのポインターを受け取ります。

戻り値

FltGetEcpListFromCallbackData は、次の NTSTATUS 値のいずれかを返します。

リターンコード	説明
STATUS_SUCCESS	EcpList は、指定されたコールバックデータオブジェクトに関連付けられている ECP リストへのポインターを受け取ります。コールバックデータオブジェクトに ECP が関連付けられていない場合は、STATUS_SUCCESSが返され、 EcpList が NULL になります。
STATUS_INVALID_PARAMETER	指定されたコールバックデータオブジェクトは、IRP ベースの作成操作ではありません。この場合、 EcpList は未定義です。

注釈

ECP リストをコールバックデータオブジェクトにアタッチするには、 FltSetEcpListIntoCallbackData ルーチンを使用します。

要件

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