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 成員、將 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
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 成員,位於 NetPnPEvent 成員NET_PNP_EVENT_NOTIFICATION中所指定的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) |