estructura NET_PNP_EVENT_NOTIFICATION (ndis.h)
La estructura NET_PNP_EVENT_NOTIFICATION describe un evento de Plug and Play de red (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 Header especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision en NET_PNP_EVENT_NOTIFICATION_REVISION_1 y el miembro Size en 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 minipuerto que llaman a NdisMNetPnPEvent, si VPortId está establecido en un valor diferente de NDIS_DEFAULT_VPORT_ID, las marcas deben establecerse en NET_EVENT_FLAGS_VPORT_ID_VALID para que VPortId surta 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. La VPort predeterminada siempre está conectada a la función física PCI Express (PCIe) del adaptador de red.
Nota
Una VPort no predeterminada con el valor VPortId especificado debe haberse creado previamente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Comentarios
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 NetEvent de esta estructura de NET_PNP_EVENT especifica un código de evento que identifica el evento PnP de red, el evento PnP NDIS o el evento de administración de energía.
El miembro Buffer , que se encuentra en la estructura 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, NetEventPortActivation y NetEventPortDeactivation.
NDIS pasa un puntero a una estructura de NET_PNP_EVENT_NOTIFICATION a la función FilterNetPnPEvent de los controladores de filtro excesivos y a la función ProtocolNetPnPEvent de los controladores de protocolo excesivos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con NDIS 6.0 y versiones posteriores. |
| Encabezado | ndis.h (incluya Ndis.h) |