FwpsPendClassify0 函数 (fwpsk.h)

标注的 classificationFn 函数调用 FwpsPendClassify0 来绘制当前分类请求。 发出请求后,标注驱动程序必须通过调用 FwpsCompleteClassify0异步完成分类请求的处理。

注意FwpsPendClassify0FwpsPendClassify的特定版本。 有关详细信息,请参阅 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

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

[in] flags

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

[in, out] classifyOut

设置为标注驱动程序的 classifyFn 函数的 classifyOut 参数。 classificationFnclassificationOut 参数在标头中列为输出参数,但它包含足够的有关输入的信息,在传递给 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)
Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

分类Fn