通过

FwpsvSwitchEventsSubscribe0 函数 （fwpsk.h）

  • 项目

FwpsvSwitchEventsSubscribe0 函数注册虚拟交换机层事件的回调入口点，例如虚拟端口创建和删除。

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

 

语法

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

参数

providerGuid

提供程序 GUID。

notifyContext

指向标注驱动程序提供的上下文的可选指针。 事件通知函数将此参数传递回驱动程序。

flags

保留。 设置为零。

reserved

保留。 设置为零。

eventDispatchTable

指向 FWPS_VSWITCH_EVENT_DISPATCH_TABLE 结构的指针，用于定义虚拟交换机层事件的回调入口点。

subscriptionId

指向包含 WFP 分配给订阅的唯一标识符的变量的指针。 调用方必须使用 FwpsvSwitchEventsUnsubscribe0 函数将订阅标识符返回到 WFP。

返回值

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

返回代码 描述
STATUS_SUCCESS
 已成功返回分类请求的句柄。 classifyHandle 参数指向的变量，该变量包含分类请求的句柄。
其他状态代码
 发生错误。

言论

标注驱动程序调用 FwpsvSwitchEventsSubscribe0 函数来注册虚拟交换机层事件的回调入口点。

回调通知函数的入口点在结构中指定并 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 结构。

标注驱动程序稍后必须调用 FwpsvSwitchEventsUnsubscribe0 来释放系统资源。

要求

要求 价值
最低支持的客户端 从 Windows 8 开始可用。
目标平台 普遍
标头 fwpsk.h （包括 Fwpsk.h）
库 Fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

另请参阅

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0