FltInsertExtraCreateParameter 函数（fltkernel.h）

FltInsertExtraCreateParameter 例程将额外的创建参数（ECP）上下文结构插入 ECP 列表中。

语法

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

[in] Filter

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

[in, out] EcpList

应添加 ecpContext 参数所 提供给 ECP 上下文结构的 ECP 列表结构的指针。

[in, out] EcpContext

指向要添加到 ECP 列表的 ECP 上下文结构的指针，EcpList 参数提供。

FltInsertExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	描述
STATUS_SUCCESS	给定的 ECP 上下文结构已成功插入到给定的 ECP 列表中。
STATUS_INVALID_PARAMETER	给定的 ECP 上下文结构已存在于给定的 ECP 列表中。在 ECP 列表插入的上下文中，如果两个 ECP 上下文结构包含相同的 GUID 值，则它们被视为相同。

FltInsertExtraCreateParameter 例程假定要插入到给定 ECP 列表中的给定 ECP 上下文结构以前由 FltAllocateExtraCreateParameter 例程分配。

插入 ECP 列表中的每个 ECP 上下文结构必须具有唯一的 GUID 值。当 ecP 上下文结构由 FltAllocateExtraCreateParameter 例程分配时，将设置此唯一值。