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 将 类型 成员设置为 标头 指定为NDIS_OBJECT_TYPE_DEFAULT、修订 成员设置为NET_PNP_EVENT_NOTIFICATION_REVISION_1,并将 大小 成员设置为NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1。
PortNumber
事件通知的源端口。 如果状态指示不特定于端口,PortNumber 为零。
NetPnPEvent
描述事件的 NET_PNP_EVENT 结构。
Flags
此事件通知的标志。
重要
对于调用 NdisMNetPnPEvent的微型端口驱动程序,如果 VPortId 设置为不同于 NDIS_DEFAULT_VPORT_ID 的值,则必须将 标志 设置为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 成员(位于 NetPnPEvent 成员NET_PNP_EVENT_NOTIFICATION中指定的NET_PNP_EVENT结构中)指定缓冲区的地址,该缓冲区包含特定于 NetEvent 成员指示的事件的信息。
NDIS 还颁发了 NDIS PnP 事件通知,例如 NetEventPause、NetEventRestart、NetEventPortActivation,以及 NetEventPortDeactivation。
NDIS 将指向NET_PNP_EVENT_NOTIFICATION结构的指针传递给 筛选器驱动程序的 FilterNetPnPEvent 函数以及过度覆盖协议驱动程序的 ProtocolNetPnPEvent 函数。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
标头 | ndis.h (包括 Ndis.h) |