NET_PNP_EVENT_NOTIFICATION-Struktur (ndis.h)

Artikel
02/29/2024

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.