FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0回调函数 (fwpsk.h)
筛选器引擎调用标注的 flowDeleteFn 标注函数,以通知标注正在由标注处理的数据流正在终止。
语法
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;
void FwpsCalloutFlowDeleteNotifyFn0(
[in] UINT16 layerId,
[in] UINT32 calloutId,
[in] UINT64 flowContext
)
{...}
参数
[in] layerId
要终止数据流的筛选层的运行时标识符。 有关详细信息,请参阅 运行时筛选层标识符。
[in] calloutId
筛选器引擎中标注的运行时标识符。 这是调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数以向筛选器引擎注册标注时返回的相同标识符。
[in] flowContext
通过调用 FwpsFlowAssociateContext0 函数,与数据流关联的最近上下文。
返回值
没有
言论
标注驱动程序通过调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数向筛选器引擎注册标注函数。
筛选器引擎在终止数据流时调用标注的 flowDeleteFn 标注函数,以便标注可以清理与数据流关联的上下文。 例如,此标注函数将在 RST 突然停止后调用,而无需先调用 classifyFn。 仅当标注驱动程序与数据流关联上下文时,筛选器引擎才会调用此标注函数。 当数据流终止时,筛选器引擎会自动从数据流中删除上下文。
仅当标注之前添加到支持数据流的筛选层上的筛选引擎时,筛选器引擎才会调用标注的 flowDeleteFn 标注函数。 如果标注驱动程序不将上下文与标注处理的数据流相关联,则它不应实现标注的 flowDeleteFn 标注函数。 在这种情况下,标注驱动程序应设置
flowDeleteFnFWPS_CALLOUT0 结构的成员,以在向筛选器引擎注册标注时 NULL。
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0类型定义为指向 flowDeleteFn 函数的指针,如下所示。
typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn
筛选器引擎在 IRQL <= DISPATCH_LEVEL 调用标注的 flowDeleteFn 标注函数。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows Vista 开始可用。 |
目标平台 | 窗户 |
标头 | fwpsk.h (包括 Fwpsk.h) |
IRQL | <= DISPATCH_LEVEL |