FwpsPendClassify0 函数 (fwpsk.h)
标注的 classificationFn 函数调用 FwpsPendClassify0 来绘制当前分类请求。 发出请求后,标注驱动程序必须通过调用 FwpsCompleteClassify0异步完成分类请求的处理。
语法
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 参数。 classificationFn 的 classificationOut 参数在标头中列为输出参数,但它包含足够的有关输入的信息,在传递给 FwpsPendClassify时,该参数对引擎非常有用。
返回值
FwpsPendClassify0 函数返回以下 NTSTATUS 代码之一。
返回代码 | 描述 |
---|---|
|
已成功对分类请求进行笔划。 |
|
引擎不允许在从中执行调用的层进行异步分类。 |
|
发生错误。 |
言论
FwpsPendClassify0 将指示事件的分类置于笔形状态。 标注驱动程序通常对分类进行笔划,以便可以在 classificationFn 标注函数的范围内执行更多处理。 然后,标注驱动程序可以将分类句柄和有关指示的任何其他相关数据传递给对性能的影响小于驱动程序标注函数的函数。 处理完成后,标注必须调用 FwpsCompleteClassify0 才能删除笔式状态。 在调用 FwpsCompleteClassify 时,标注驱动程序必须返回填充 FWPS_CLASSIFY_OUT0 结构,就像在内联分类中一样。
FwpsPendClassify0 递增 classificationHandle 参数中传递的分类句柄的引用计数。 标注驱动程序调用此函数后,可以调用 FwpsReleaseClassifyHandle0 释放本地实例。 调用 FwpsCompleteClassify0 时,将自动递减对句柄的引用。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 7 开始可用。 |
目标平台 | 普遍 |
标头 | fwpsk.h (包括 Fwpsk.h) |
库 | Fwpkclnt.lib |
IRQL | <= DISPATCH_LEVEL |