structure NET_PNP_EVENT_NOTIFICATION (ndis.h)
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) |