Share via

структура NET_PNP_EVENT_NOTIFICATION (ndis.h)

  • Статья

Структура NET_PNP_EVENT_NOTIFICATION описывает событие сетевого Plug and Play (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

Структура NDIS_OBJECT_HEADER для структуры NET_PNP_EVENT_NOTIFICATION. NDIS задает элемент Type структуры, указанной в заголовке , NDIS_OBJECT_TYPE_DEFAULT, элемент 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 флагам необходимо задать значение 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 по умолчанию всегда подключен к физической функции (PF) PCI Express (PCIe) сетевого адаптера.

Примечание

Неразрешимый VPort с указанным значением VPortId должен быть ранее создан с помощью запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.

Комментарии

Когда операционная система выдает системное событие PnP или событие управления питанием целевому объекту устройства, представляющего адаптер, NDIS преобразует это событие в NET_PNP_EVENT_NOTIFICATION структуру.

Элемент NetPnPEvent является NET_PNP_EVENT структурой. Элемент NetEvent этой структуры NET_PNP_EVENT указывает код события, который идентифицирует сетевое событие PnP, событие NDIS PnP или событие управления питанием.

Элемент Buffer , который находится в структуре NET_PNP_EVENT, указанной в элементе NetPnPEvent NET_PNP_EVENT_NOTIFICATION, указывает адрес буфера, который содержит сведения, относящиеся к событию, указанному элементом NetEvent .

NDIS также выдает уведомления о событиях PnP для событий NDIS PnP, таких как NetEventPause, NetEventRestart, NetEventPortActivation и NetEventPortDeactivation.

NDIS передает указатель на структуру NET_PNP_EVENT_NOTIFICATION на функцию FilterNetPnPEvent для переопределяющих драйверов фильтров и на функцию ProtocolNetPnPEvent для превышения драйверов протокола.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть ndis.h (включая Ndis.h)

См. также раздел

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent