structure NET_PNP_EVENT_NOTIFICATION (ndis.h)

Article
08/07/2023

La structure NET_PNP_EVENT_NOTIFICATION décrit un événement de Plug-and-Play réseau (PnP), un événement PnP NDIS ou un événement de gestion de l’alimentation.

Syntaxe

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;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NET_PNP_EVENT_NOTIFICATION. NDIS définit le membre Type de la structure que l’en-tête spécifie sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NET_PNP_EVENT_NOTIFICATION_REVISION_1 et le membre Size sur NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.

PortNumber

Port source de la notification d’événement. Si l’indication status n’est pas spécifique à un port, PortNumber est égal à zéro.

NetPnPEvent

Structure NET_PNP_EVENT qui décrit l’événement.

Flags

Indicateurs pour cette notification d’événement.

Important

Pour les pilotes miniport appelant NdisMNetPnPEvent, si VPortId est défini sur une valeur différente de NDIS_DEFAULT_VPORT_ID les indicateurs doivent être définis sur NET_EVENT_FLAGS_VPORT_ID_VALID pour que VPortId prenne effet.

Les autres valeurs des indicateurs sont réservées à NDIS.

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui spécifie un identificateur de commutateur. L’identificateur de commutateur est un entier compris entre zéro et le nombre de commutateurs pris en charge par la carte réseau. Une valeur NDIS_DEFAULT_SWITCH_ID indique le commutateur de carte réseau par défaut.

VPortId

Valeur NDIS_NIC_SWITCH_VPORT_ID qui identifie de manière unique le port virtuel (VPort) sur la carte réseau.

La valeur NDIS_DEFAULT_VPORT_ID spécifie le VPort par défaut sur le commutateur. Le VPort par défaut est toujours attaché à la fonction physique (PF) PCI Express (PCIe) de la carte réseau.

Notes

Un VPort non par défaut avec la valeur VPortId spécifiée doit avoir déjà été créé via une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

Remarques

Lorsque le système d’exploitation émet un événement PnP système ou un événement de gestion de l’alimentation sur un objet d’appareil cible qui représente une carte, NDIS convertit l’événement en une structure NET_PNP_EVENT_NOTIFICATION.

Le membre NetPnPEvent est une structure NET_PNP_EVENT . Le membre NetEvent de cette structure NET_PNP_EVENT spécifie un code d’événement qui identifie l’événement PnP réseau, l’événement PnP NDIS ou l’événement de gestion de l’alimentation.

Le membre Buffer , qui se trouve dans la structure NET_PNP_EVENT spécifiée dans le membre NetPnPEvent de NET_PNP_EVENT_NOTIFICATION, spécifie l’adresse d’une mémoire tampon qui contient des informations spécifiques à l’événement indiqué par le membre NetEvent .

NDIS émet également des notifications d’événements PnP pour les événements PnP NDIS tels que NetEventPause, NetEventRestart, NetEventPortActivation et NetEventPortDeactivation.

NDIS transmet un pointeur vers une structure de NET_PNP_EVENT_NOTIFICATION à la fonction FilterNetPnPEvent de surlysation des pilotes de filtre et à la fonction ProtocolNetPnPEvent de surlysant les pilotes de protocole.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
En-tête	ndis.h (inclure Ndis.h)

Voir aussi