NET_DEVICE_PNP_EVENT 結構 (ndis.h)
NET_DEVICE_PNP_EVENT結構會定義迷你埠適配卡的裝置即插即用 (PnP) 事件。
語法
typedef struct _NET_DEVICE_PNP_EVENT {
NDIS_OBJECT_HEADER Header;
NDIS_PORT_NUMBER PortNumber;
NDIS_DEVICE_PNP_EVENT DevicePnPEvent;
PVOID InformationBuffer;
ULONG InformationBufferLength;
UCHAR *NdisReserved[2 sizeof(PVOID)];
} NET_DEVICE_PNP_EVENT, *PNET_DEVICE_PNP_EVENT;
成員
Header
NET_DEVICE_PNP_EVENT 結構的NDIS_OBJECT_HEADER結構。 NDIS 會設定 Header 指定要NDIS_OBJECT_TYPE_DEFAULT的 Type 成員、要NET_DEVICE_PNP_EVENT_REVISION_1的 Revision 成員,以及要NDIS_SIZEOF_NET_DEVICE_PNP_EVENT_REVISION_1的 Size 成員。
PortNumber
PnP 事件通知的來源埠。 如果狀態指示不是埠特有的,
PortNumber 為零。
DevicePnPEvent
將 PnP 事件描述為下列其中一項的事件程式代碼:
NdisDevicePnPEventSurpriseRemoved
(NIC) 的網路介面卡已從電腦意外移除。 如需詳細資訊,請參閱 處理 NIC 的意外移除。
NdisDevicePnPEventPowerProfileChanged
主機系統的電源配置檔已變更。
InformationBuffer
緩衝區的指標。 如果 NDIS 將 DevicePnPEvent 成員設定為 NdisDevicePnPEventPowerProfileChanged,此緩衝區將包含 NDIS 設定為下列其中一個值的 ULONG:
NdisPowerProfileBattery
主機系統正在電池電力上執行。
NdisPowerProfileAcOnline
主機系統正在 AC 電源上執行。
如果 NDIS 將 DevicePnPEvent 設定為 NdisDevicePnPEventSurpriseRemoved,InformationBuffer 為 NULL。
InformationBufferLength
InformationBuffer 成員中緩衝區的長度,以位元組為單位。
NdisReserved[2 * sizeof(PVOID)]
保留給 NDIS。
備註
若要提供裝置 PnP 事件通知,NDIS 會將指標傳遞給 NET_DEVICE_PNP_EVENT 結構至 MiniportDevicePnPEventNotify 或 FilterDevicePnPEventNotify 函式 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
標頭 | ndis.h (包含 Ndis.h) |