FwpsPendClassify0 函数 (fwpsk.h)

项目
02/29/2024

标注的分类Fn 函数调用 FwpsPendClassify0 以提交当前分类请求。提交请求后，标注驱动程序必须通过调用 FwpsCompleteClassify0 异步完成分类请求的处理。

注意FwpsPendClassify0 是 FwpsPendClassify 的特定版本。有关详细信息，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本。

语法

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

参数

[in] classifyHandle

分类句柄，用于标识标注驱动程序在当前层的处理。此句柄是通过调用 FwpsAcquireClassifyHandle0。

[in] filterId

分类Fn 函数的筛选器参数的 FilterId 成员的值。有关 FilterId 成员的详细信息，请参阅 FWPS_FILTER1。

[in] flags

保留供将来使用。设置为零。

[in, out] classifyOut

设置为标注驱动程序的分类 Fn 函数的分类输出参数。 分类Fn 的classeOut 参数作为输出参数在标头中列出，但它包含足够的有关输入的信息，在传递给 FwpsPendClassify 时对引擎有用。

返回值

FwpsPendClassify0 函数返回以下 NTSTATUS 代码之一。

返回代码	说明
STATUS_SUCCESS	分类请求已成功提交。
STATUS_FWP_CANNOT_PEND	引擎不允许在发出调用的层上进行异步分类。
其他状态代码	出现了错误。

注解

FwpsPendClassify0 将指示事件的分类置于已插入状态。标注驱动程序通常将分类，以便可以在 classificationFn 标注函数范围之外完成更多处理。然后，标注驱动程序可以将分类句柄和有关指示的任何其他相关数据传递给对性能的影响小于驱动程序标注函数的函数。处理完成后，标注必须调用 FwpsCompleteClassify0 以删除所呈现的状态。调用 FwpsCompleteClassify 时，标注驱动程序必须返回填充 FWPS_CLASSIFY_OUT0 结构，就像在内联分类中一样。

FwpsPendClassify0 递增在 classificationHandle 参数中传递的分类句柄的引用计数。标注驱动程序调用此函数后，它可以调用 FwpsReleaseClassifyHandle0 以释放本地实例。调用 FwpsCompleteClassify0 时，对句柄的引用将自动递减。

要求

要求	值
最低受支持的客户端	从 Windows 7 开始可用。
目标平台	通用
标头	fwpsk.h (包括 Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL