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) |