FltGetEcpListFromCallbackData 函数 (fltkernel.h)

项目
02/26/2024

FltGetEcpListFromCallbackData 例程返回指向与给定创建操作 callback-data 对象关联的 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 列表的指针。如果 callback-data 对象没有关联的 ECP，则返回 STATUS_SUCCESS，EcpList 为 NULL。
STATUS_INVALID_PARAMETER	给定的回调数据对象不是基于 IRP 的创建操作。在这种情况下， EcpList 是未定义的。

注解

若要将 ECP 列表附加到回调数据对象，请使用 FltSetEcpListIntoCallbackData 例程。

要求

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