NET_PNP_EVENT_NOTIFICATION Struktur (ndis.h)
Die NET_PNP_EVENT_NOTIFICATION Struktur beschreibt ein Netzwerk-Plug-and-Play-Ereignis (PnP), ein NDIS PnP-Ereignis oder ein Energieverwaltungsereignis.
Syntax
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;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die NET_PNP_EVENT_NOTIFICATION Struktur. NDIS legt das element Type der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_DEFAULT, das Revisions element auf NET_PNP_EVENT_NOTIFICATION_REVISION_1 und das Size Member auf NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.
PortNumber
Der Quellport der Ereignisbenachrichtigung. Wenn die Statusanzeige nicht spezifisch für einen Port ist, ist PortNumber Null.
NetPnPEvent
Eine NET_PNP_EVENT Struktur, die das Ereignis beschreibt.
Flags
Flags für diese Ereignisbenachrichtigung.
Wichtig
Für Miniporttreiber, die NdisMNetPnPEvent-aufrufen, muss VPortId- auf einen anderen Wert als NDIS_DEFAULT_VPORT_ID festgelegt werden, müssen Flags auf NET_EVENT_FLAGS_VPORT_ID_VALID festgelegt werden, damit VPortId wirksam wird.
Andere Werte für Flags sind für NDIS reserviert.
SwitchId
Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner angibt. Der Switchbezeichner ist eine ganze Zahl zwischen Null und der Anzahl der Switches, die der Netzwerkadapter unterstützt. Ein NDIS_DEFAULT_SWITCH_ID Wert gibt den Standardmäßigen Netzwerkadapterswitch an.
VPortId
Ein NDIS_NIC_SWITCH_VPORT_ID Wert, der den virtuellen Port (VPort) auf dem Netzwerkadapter eindeutig identifiziert.
Ein Wert von NDIS_DEFAULT_VPORT_ID gibt den Standard-VPort auf dem Switch an. Der Standard-VPort ist immer an die PHYSISCHE Funktion PCI Express (PCIe) des Netzwerkadapters angeschlossen.
Anmerkung
Ein nicht standardmäßiger VPort mit dem angegebenen VPortId- Wert muss zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTerstellt worden sein.
Bemerkungen
Wenn das Betriebssystem ein System-PnP-Ereignis oder ein Energieverwaltungsereignis auf ein Zielgerätobjekt ausgibt, das einen Adapter darstellt, übersetzt NDIS das Ereignis in eine NET_PNP_EVENT_NOTIFICATION Struktur.
Das NetPnPEvent Member ist eine NET_PNP_EVENT Struktur. Das NetEvent--Mitglied dieser NET_PNP_EVENT-Struktur gibt einen Ereigniscode an, der das Netzwerk-PnP-Ereignis, das NDIS-PnP-Ereignis oder das Power Management-Ereignis identifiziert.
Das Buffer-Element, das sich in der NET_PNP_EVENT Struktur befindet, die im NetPnPEvent--Element von NET_PNP_EVENT_NOTIFICATION angegeben ist, gibt die Adresse eines Puffers an, der informationen enthält, die für das Ereignis spezifisch sind, das vom NetEvent Member angegeben wird.
NDIS gibt auch PnP-Ereignisbenachrichtigungen für NDIS-PnP-Ereignisse wie NetEventPause, NetEventRestart, NetEventPortActivationund NetEventPortDeactivationaus.
NDIS übergibt einen Zeiger an eine NET_PNP_EVENT_NOTIFICATION Struktur an die FilterNetPnPEvent- Funktion von Überlyingfiltertreibern und an die ProtocolNetPnPEvent- Funktion der überlappenden Protokolltreiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ndis.h (include Ndis.h) |