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 指定要NDIS_OBJECT_TYPE_DEFAULT的 Type 成員、要NET_PNP_EVENT_NOTIFICATION_REVISION_1的 Revision 成員，以及要NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1的 Size 成員。
PortNumber
事件通知的來源埠。 如果狀態指示不是埠特有的， PortNumber 為零。
NetPnPEvent
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
NDIS_NIC_SWITCH_VPORT_ID值，可唯一識別網路適配器上的虛擬埠 (VPort) 。
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 事件發出 PnP 事件通知，例如 NetEventPause、NetEventRestart、NetEventPortActivation 和 NetEventPortDeactivation。
NDIS 會將指標傳遞至NET_PNP_EVENT_NOTIFICATION結構的 FilterNetPnPEvent 函式，以過度套用篩選驅動程式，並將指標傳遞至過度配置通訊協定驅動程式的 ProtocolNetPnPEvent 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 標頭 | ndis.h (包含 Ndis.h) |