FltSetEcpListIntoCallbackData 函数 (fltkernel.h)

项目
08/07/2023

FltSetEcpListIntoCallbackData 例程将额外的创建参数上下文结构 (ECP) 列表附加到创建操作 callback-data 对象。

语法

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

参数

[in] Filter

指向微筛选器驱动程序的不透明筛选器指针。此指针唯一标识微筛选器驱动程序，只要加载微筛选器驱动程序，它就保持不变。

CallbackData

指向 类型为 FLT_CALLBACK_DATA 的回调数据对象的指针，该对象表示创建操作。

[in] EcpList

指向要附加到 callback-data 对象的 ECP 列表的指针，该列表包含一个或多个 ECP。

返回值

FltSetEcpListIntoCallbackData 返回以下 NTSTATUS 值之一：

返回代码	说明
STATUS_SUCCESS	给定的 ECP 列表已成功附加到给定的回调数据对象。
STATUS_INVALID_PARAMETER_2	给定的回调数据对象不是基于 IRP 的创建操作。
STATUS_INVALID_PARAMETER_3	ECP 列表已附加到给定回调数据对象。

注解

FltSetEcpListIntoCallbackData 例程提供了一种机制，用于将文件系统筛选器堆栈中的额外创建参数传递到基础微筛选器和旧筛选器驱动程序。

若要从给定回调数据对象检索附加的 ECP 列表，请使用 FltGetEcpListFromCallbackData 例程。

要求

要求	值
最低受支持的客户端	此例程从 Windows Vista 开始可用。
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL