FltRemoveExtraCreateParameter 函数 (fltkernel.h)

项目
08/07/2023

FltRemoveExtraCreateParameter 例程在 ECP 列表中搜索 ECP 上下文结构，如果找到，则将其从 ECP 列表中分离。

语法

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

参数

[in] Filter

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

[in, out] EcpList

指向额外创建参数的指针 (ECP) 列表，该列表包含要从给定列表分离的 ECP 上下文结构。

[in] EcpType

指向用户定义的 GUID 的指针，该 GUID 唯一标识要从列表中分离的 ECP 上下文结构。

[out] EcpContext

指向分离的 ECP 上下文结构的指针。如果 ECP 上下文结构从给定列表成功分离，则此参数将设置为指向分离的 ECP 上下文结构。如果在给定的 ECP 列表中找不到 ECP 上下文结构，则此参数设置为 NULL。

[out, optional] EcpContextSize

接收分离的 ECP 上下文结构大小的可选参数。如果在调用例程时此参数存在，则参数将接收分离的 ECP 上下文结构的大小（以字节为单位）。如果在给定的 ECP 列表中找不到给定的 ECP 上下文结构，则此参数未定义。

返回值

FltRemoveExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	说明
STATUS_SUCCESS	给定的 ECP 上下文结构已成功从给定的 ECP 列表分离。
STATUS_NOT_FOUND	在给定的 ECP 列表中找不到给定的 ECP 上下文结构。

注解

FltRemoveExtraCreateParameter 例程在 EcpList 参数提供的 ECP 列表中搜索 EcpType 参数给定的 ECP 上下文结构。如果列表中存在 ECP 上下文结构，则它与列表分离， EcpContext 参数设置为指向它，例程返回STATUS_SUCCESS。如果列表中不存在 ECP 上下文结构， 则 EcpContext 参数设置为 NULL ，例程返回STATUS_NOT_FOUND。

注意此例程不会释放 ECP 上下文结构的内存池。若要释放 ECP 上下文结构，请首先调用此例程将其从列表中分离，然后调用 FltFreeExtraCreateParameter 例程以释放 ECP 上下文结构本身。

要求

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