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

指向 ECP 列表结构的指针， EcpContext 参数提供的 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 例程分配时，将设置此唯一值。