estructura NET_PNP_EVENT_NOTIFICATION (ndis.h)
La estructura NET_PNP_EVENT_NOTIFICATION describe un evento de red Plug and Play (PnP), un evento PnP de NDIS o un evento de administración de energía.
Sintaxis
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;
Miembros
Header
Estructura NDIS_OBJECT_HEADER de la estructura NET_PNP_EVENT_NOTIFICATION. NDIS establece el miembro Type de la estructura que Encabezado especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision de en NET_PNP_EVENT_NOTIFICATION_REVISION_1 y el miembro Size para NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.
PortNumber
Puerto de origen de la notificación de eventos. Si la indicación de estado no es específica de un puerto, portNumber es cero.
NetPnPEvent
Estructura NET_PNP_EVENT que describe el evento.
Flags
Marcas para esta notificación de eventos.
Importante
Para los controladores de miniportar que llaman a NdisMNetPnPEvent, si VPortId se establece en un valor diferente de NDIS_DEFAULT_VPORT_ID, flags debe establecerse en NET_EVENT_FLAGS_VPORT_ID_VALID para que VPortId surtan efecto.
Otros valores de flags están reservados para NDIS.
SwitchId
Valor de NDIS_NIC_SWITCH_ID que especifica un identificador de modificador. El identificador del conmutador es un entero entre cero y el número de conmutadores que admite el adaptador de red. Un valor de NDIS_DEFAULT_SWITCH_ID indica el conmutador de adaptador de red predeterminado.
VPortId
Valor de NDIS_NIC_SWITCH_VPORT_ID que identifica de forma única el puerto virtual (VPort) en el adaptador de red.
Un valor de NDIS_DEFAULT_VPORT_ID especifica el VPort predeterminado en el conmutador. El VPort predeterminado siempre está conectado a la función física PCI Express (PCIe) del adaptador de red.
Nota
Un VPort no predeterminado con el valor de VPortId especificado debe haberse creado previamente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Observaciones
Cuando el sistema operativo emite un evento PnP del sistema o un evento de administración de energía a un objeto de dispositivo de destino que representa un adaptador, NDIS convierte el evento en una estructura de NET_PNP_EVENT_NOTIFICATION.
El miembro NetPnPEvent es una estructura NET_PNP_EVENT. El miembro de netEvent de esta estructura de NET_PNP_EVENT especifica un código de evento que identifica el evento PnP de red, el evento PnP de NDIS o el evento de administración de energía.
El miembro Buffer, que se encuentra en la estructura de NET_PNP_EVENT que se especifica en el miembro netPnPEvent de NET_PNP_EVENT_NOTIFICATION, especifica la dirección de un búfer que contiene información específica del evento indicado por el miembro NetEvent.
NDIS también emite notificaciones de eventos PnP para eventos PnP de NDIS, como NetEventPause, NetEventRestart, NetEventPortActivationy NetEventPortDeactivation.
NDIS pasa un puntero a una estructura de NET_PNP_EVENT_NOTIFICATION al FilterNetPnPEvent función de los controladores de filtro excesivos y a la función ProtocolNetPnPEvent función de controladores de protocolo excesivo.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 6.0 y versiones posteriores. |
| encabezado de | ndis.h (incluya Ndis.h) |