estructura NET_PNP_EVENT_NOTIFICATION (ndis.h)

  • Artículo

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)

Consulte también

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent