NET_PNP_EVENT_NOTIFICATION 结构 (ndis.h)

  • 项目

NET_PNP_EVENT_NOTIFICATION结构描述网络即插即用 (PnP) 事件、NDIS PnP 事件或电源管理事件。

语法

typedef struct _NET_PNP_EVENT_NOTIFICATION {
  NDIS_OBJECT_HEADER       Header;
  NDIS_PORT_NUMBER         PortNumber;
  NET_PNP_EVENT            NetPnPEvent;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NET_PNP_EVENT_NOTIFICATION, *PNET_PNP_EVENT_NOTIFICATION;

成员

Header

NET_PNP_EVENT_NOTIFICATION 结构的NDIS_OBJECT_HEADER结构。 NDIS 将 Header 指定的结构的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT，Revision 成员设置为NET_PNP_EVENT_NOTIFICATION_REVISION_1，将 Size 成员设置为NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1。

PortNumber

事件通知的源端口。 如果状态指示不是特定于端口的， 则 PortNumber 为零。

NetPnPEvent

描述 事件的NET_PNP_EVENT 结构。

Flags

此事件通知的标志。

重要

对于调用 NdisMNetPnPEvent 的微型端口驱动程序，如果将 VPortId 设置为与 NDIS_DEFAULT_VPORT_ID 不同的值，则必须将 Flags 设置为 NET_EVENT_FLAGS_VPORT_ID_VALID才能使 VPortId 生效。

标志的其他值是为 NDIS 保留的。

SwitchId

一个NDIS_NIC_SWITCH_ID值，该值指定开关标识符。 交换机标识符是介于零和网络适配器支持的交换机数之间的整数。 NDIS_DEFAULT_SWITCH_ID值指示默认网络适配器交换机。

VPortId

一个唯一标识网络适配器上 VPort) (虚拟端口的NDIS_NIC_SWITCH_VPORT_ID值。

值 NDIS_DEFAULT_VPORT_ID 指定交换机上的默认 VPort。 默认 VPort 始终连接到网络适配器的 PCI Express (PCIe) 物理功能 (PF) 。

注意

具有指定 VPortId 值的非默认 VPort 之前必须通过 OID_NIC_SWITCH_CREATE_VPORT 的 OID 方法请求创建。

注解

当操作系统向表示适配器的目标设备对象发出系统 PnP 事件或电源管理事件时，NDIS 会将该事件转换为NET_PNP_EVENT_NOTIFICATION结构。

NetPnPEvent 成员是NET_PNP_EVENT结构。 此 NET_PNP_EVENT 结构的 NetEvent 成员指定标识网络 PnP 事件、NDIS PnP 事件或电源管理事件的事件代码。

Buffer 成员位于 NET_PNP_EVENT_NOTIFICATION 的 NetPnPEvent 成员中指定的 NET_PNP_EVENT 结构中，它指定包含特定于 NetEvent 成员指示的事件的信息的缓冲区的地址。

NDIS 还为 NDIS PnP 事件（例如 NetEventPause、NetEventRestart、NetEventPortActivation 和 NetEventPortDeactivation）发出 PnP 事件通知。

NDIS 将指向NET_PNP_EVENT_NOTIFICATION结构的指针传递给过分筛选器驱动程序的 FilterNetPnPEvent 函数和过度覆盖协议驱动程序的 ProtocolNetPnPEvent 函数。

要求

要求 值
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
标头 ndis.h (包括 Ndis.h)

另请参阅

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent