структура 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) |