NET_PNP_EVENT_NOTIFICATION-Struktur (ndis.h)
Die NET_PNP_EVENT_NOTIFICATION-Struktur beschreibt ein PnP-Ereignis (Network Plug & Play), 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;
Member
Header
Die NDIS_OBJECT_HEADER-Struktur für die NET_PNP_EVENT_NOTIFICATION-Struktur. NDIS legt den Typmember der Struktur, den Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NET_PNP_EVENT_NOTIFICATION_REVISION_1 und das Size-Element auf NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1 fest.
PortNumber
Der Quellport der Ereignisbenachrichtigung. Wenn die status Angabe nicht portspezifisch ist, ist PortNumber null.
NetPnPEvent
Eine NET_PNP_EVENT-Struktur , die das Ereignis beschreibt.
Flags
Flags für diese Ereignisbenachrichtigung.
Wichtig
Wenn VPortId für Miniporttreiber, die NdisMNetPnPEvent aufrufen, auf einen anderen Wert als NDIS_DEFAULT_VPORT_ID festgelegt ist, 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 von Switches, die vom Netzwerkadapter unterstützt werden. Ein NDIS_DEFAULT_SWITCH_ID-Wert gibt den Standard-Netzwerkadapterswitch an.
VPortId
Ein NDIS_NIC_SWITCH_VPORT_ID Wert, der den virtuellen Port (VPort) auf dem Netzwerkadapter eindeutig identifiziert.
Der Wert NDIS_DEFAULT_VPORT_ID gibt den Standard-VPort auf dem Switch an. Der Standard-VPort ist immer an die PHYSISCHE FUNKTION (PCIe) des Netzwerkadapters angefügt.
Hinweis
Ein nicht standardmäßiger VPort mit dem angegebenen VPortId-Wert muss zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT erstellt worden sein.
Hinweise
Wenn das Betriebssystem ein PnP-Systemereignis oder ein Energieverwaltungsereignis an ein Zielgerätobjekt ausgibt, das einen Adapter darstellt, übersetzt NDIS das Ereignis in eine NET_PNP_EVENT_NOTIFICATION-Struktur.
Das NetPnPEvent-Element ist eine NET_PNP_EVENT-Struktur . Das NetEvent-Element dieser NET_PNP_EVENT-Struktur gibt einen Ereigniscode an, der das Netzwerk-PnP-Ereignis, das NDIS-PnP-Ereignis oder das Energieverwaltungsereignis identifiziert.
Das Buffer-Element , das sich in der NET_PNP_EVENT-Struktur befindet, die im NetPnPEvent-Member von NET_PNP_EVENT_NOTIFICATION angegeben ist, gibt die Adresse eines Puffers an, der Informationen enthält, die spezifisch für das Ereignis sind, das vom NetEvent-Element angegeben wird.
NDIS gibt auch PnP-Ereignisbenachrichtigungen für NDIS-PnP-Ereignisse wie NetEventPause, NetEventRestart, NetEventPortActivation und NetEventPortDeactivation aus.
NDIS übergibt einen Zeiger auf eine NET_PNP_EVENT_NOTIFICATION Struktur an die FilterNetPnPEvent-Funktion der überlappenden Filtertreiber und an die ProtocolNetPnPEvent-Funktion der überlappenden Protokolltreiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Kopfzeile | ndis.h (include Ndis.h) |