FltGetNextExtraCreateParameter 函数 (fltkernel.h)

项目
02/29/2024

FltGetNextExtraCreateParameter 例程返回指向给定 ECP 列表中的下一个 (或第一个) 额外创建参数上下文结构 (ECP) 的指针。

语法

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

参数

[in] Filter

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

[in] EcpList

指向要检查的 ECP 列表的指针。

[in, optional] CurrentEcpContext

指向给定 ECP 列表中的 ECP 的可选指针。如果存在， FltGetNextExtraCreateParameter 在 CurrentEcpContext ECP 之后返回 ECP。如果 CurrentEcpContext 为 NULL， 则 FltGetNextExtraCreateParameter 返回列表中的第一个 ECP。

[out, optional] NextEcpType

可选参数，用于接收指向返回的 ECP 的 GUID 的指针。

[out, optional] NextEcpContext

可选参数，用于接收指向返回的 ECP 的指针。

[out, optional] NextEcpContextSize

可选参数，用于接收返回的 ECP 的大小（以字节为单位）。

返回值

FltGetNextExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	说明
STATUS_SUCCESS	在 EcpList ECP 列表中找到了 ECP。
STATUS_NOT_FOUND	EcpList ECP 列表为空或 CurrentEcpContext 是列表中的最后一个 ECP，即没有下一个 ECP list 元素) 。此外，NextEcpContext 设置为 NULL，NextEcpContextSize 设置为零。
STATUS_INVALID_PARAMETER	EcpList 参数为 NULL。

注解

此例程从 Windows Vista 开始可用。

FltGetNextExtraCreateParameter 例程以非循环方式处理 ECP 列表。也就是说，如果 CurrentEcpContext 参数指向的 ECP 是 ECP 列表中的最后一个 ECP 元素，则列表中没有“下一个”ECP，并且例程返回STATUS_NOT_FOUND。

要求

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