NET_DEVICE_PNP_EVENT 结构 (ndis.h)

项目
08/07/2023

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 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为 NET_DEVICE_PNP_EVENT_REVISION_1，并将 Size 成员设置为 NDIS_SIZEOF_NET_DEVICE_PNP_EVENT_REVISION_1。

PortNumber

PnP 事件通知的源端口。如果状态指示不是特定于端口的，
PortNumber 为零。

DevicePnPEvent

将 PnP 事件描述为以下内容之一的事件代码：

NdisDevicePnPEventSurpriseRemoved

NIC) 卡 (网络接口意外从计算机中删除。有关详细信息，请参阅处理 NIC 的意外删除。

NdisDevicePnPEventPowerProfileChanged

主机系统的电源配置文件已更改。

InformationBuffer

指向缓冲区的指针。如果 NDIS 将 DevicePnPEvent 成员设置为 NdisDevicePnPEventPowerProfileChanged，则此缓冲区将包含 NDIS 设置为以下值之一的 ULONG：

NdisPowerProfileBattery

主机系统使用电池电源运行。

NdisPowerProfileAcOnline

主机系统在交流电源上运行。

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

另请参阅

FilterDevicePnPEventNotify

MiniportDevicePnPEventNotify

NDIS_OBJECT_HEADER

通过