Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |