FltFindExtraCreateParameter 函数（fltkernel.h）

项目
02/06/2025

FltFindExtraCreateParameter 例程在给定 ECP 列表中搜索给定类型的 ECP 上下文结构，并在找到该结构时返回指向此结构的指针。

语法

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

参数

[in] Filter

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

[in] EcpList

指向要在其中搜索 ECP 上下文结构的 ECP 列表结构的指针（由 EcpType 参数提供）。

[in] EcpType

指向唯一标识每个 ECP 上下文结构的 GUID 的指针。 FltFindExtraCreateParamter 例程使用此 GUID 值来确定 ECP 列表中是否存在 ECP 上下文结构（由 EcpList 参数提供）。

[out, optional] EcpContext

接收指向找到的 ECP 上下文结构的指针的可选参数。如果在 ECP 列表中找不到 ECP 上下文结构，EcpContext 设置为 NULL。如果 EcpContext 设置为调用方 NULL，则可以使用此例程的返回值来确定 ECP 上下文结构是否位于 ECP 列表中。

[out, optional] EcpContextSize

可选参数，用于接收找到的 ECP 上下文结构的大小（以字节为单位）。如果在 ECP 列表中找不到 ECP 上下文结构，EcpContextSize 设置为零。

返回值

FltFindExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	描述
STATUS_SUCCESS	ECP 上下文结构（由 EcpType 参数指定）在 ECP 列表中（由 EcpList 参数指定）。
STATUS_NOT_FOUND	ECP 上下文结构（由 EcpType 参数指定）未在 ECP 列表中找到（由 EcpList 参数指定）。

要求

要求	价值
最低支持的客户端	此例程从 Windows Vista 开始可用。
目标平台	普遍
标头	fltkernel.h （包括 Fltkernel.h）
库	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL