NDIS_PM_PARAMETERS-Struktur (ntddndis.h)

  • Artikel

Die NDIS_PM_PARAMETERS-Struktur gibt die aktuellen oder neuen Hardwarefunktionen für die Energieverwaltung an, die für einen Netzwerkadapter aktiviert sind.

Syntax

typedef struct _NDIS_PM_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              EnabledWoLPacketPatterns;
  ULONG              EnabledProtocolOffloads;
  ULONG              WakeUpFlags;
  ULONG              MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;

Member

Header

Der Typ, die Revision und die Größe der NDIS_PM_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_PM_PARAMETERS-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_PM_PARAMETERS_REVISION_2

Verschiedene Änderungen für NDIS 6.30 wurden hinzugefügt.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2 fest.

NDIS_PM_PARAMETERS_REVISION_1

Ursprüngliche Version für NDIS 6.20.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1 fest.

EnabledWoLPacketPatterns

Ein ULONG-Wert , der einen bitweisen OR von Flags enthält, die funktionen entsprechen, die der Miniporttreiber im SupportedWoLPacketPatterns-Member der NDIS_PM_CAPABILITIES-Struktur gemeldet hat. NDIS verwendet diese Flags, um die Wake-on-LAN-Muster (WOL) zu aktivieren, die ein Netzwerkadapter verwendet, um den lokalen Computer aus einem Zustand mit geringer Energieleistung zu reaktivieren. Weitere Informationen zu WOL-Mustern finden Sie unter NDIS_PM_WOL_PATTERN.

Die folgenden Flags werden verwendet:

NDIS_PM_WOL_BITMAP_PATTERN_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er ein Paket empfängt, das einem konfigurierten Bitmapmuster entspricht.

NDIS_PM_WOL_MAGIC_PACKET_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er ein WOL-Magic-Paket empfängt. Ein Magic-Paket enthält in seiner Nutzlast eine Zeichenfolge von sechs Bytes mit dem Wert 0xFF, gefolgt von 16 zusammenhängenden Kopien der MAC-Adresse (Media Access Control, Medienzugriffssteuerung) des empfangenden Netzwerkadapters.

NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er eine EAPOL-Anforderungsbezeichnermeldung empfängt.

NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er ein IPv4 TCP SYN-Paket empfängt. Remotehosts senden TCP SYN-Pakete, um eine TCP-Verbindung mit dem lokalen Computer zu initiieren.

NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er ein IPv6 TCP SYN-Paket empfängt.

NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED

Wenn dieses Flag festgelegt ist, muss der Netzwerkadapter alle nullgefüllten oder nicht angegebenen Werte für IPv4-Adressen und TCP/UDP-Ports in einem WOL-Muster als Feldhalterwerte behandeln. Auf diese Weise entspricht der Wildcardwert jeder IPv4-Adresse und jedem Portwert des eingehenden Pakets an dem durch das WOL-Muster angegebenen Speicherort.

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn die folgenden Musterabgleichsbedingungen zutreffen:

  • Jeder Wert aus dem eingehenden Paket an dem durch das WOL-Muster angegebenen Speicherort ist eine Übereinstimmung, wenn das WOL-Muster für diesen Speicherort einen Feldhalterwert enthält.
  • Ein Wert aus dem eingehenden Paket an dem durch das WOL-Muster angegebenen Speicherort ist eine Übereinstimmung, wenn das WOL-Muster für diesen Speicherort einen nichtzero-Wert enthält, der dem Wert des Pakets entspricht.

Hinweis

 Mit diesem Flag aktivierte Feldhalterwerte können nicht angegebene IPv4-Quell- und Zieladressen sowie nicht angegebene Quell- und Zielports enthalten.

NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED

Wenn dieses Flag festgelegt ist, muss der Netzwerkadapter alle nullgefüllten oder nicht angegebenen Werte für IPv6-Adressen und TCP/UDP-Ports in einem WOL-Muster als Feldhalterwerte behandeln. Auf diese Weise entspricht der Feldhalterwert jeder IPv6-Adresse und jedem Portwert des eingehenden Pakets an dem durch das WOL-Muster angegebenen Speicherort.

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn die folgenden Musterabgleichsbedingungen zutreffen:

  • Jeder Wert aus dem eingehenden Paket an dem durch das WOL-Muster angegebenen Speicherort ist eine Übereinstimmung, wenn das WOL-Muster für diesen Speicherort einen Feldhalterwert enthält.
  • Ein Wert aus dem eingehenden Paket an dem durch das WOL-Muster angegebenen Speicherort ist eine Übereinstimmung, wenn das WOL-Muster für diesen Speicherort einen nichtzero-Wert enthält, der dem Wert des Pakets entspricht.

Hinweis

 Mit diesem Flag aktivierte Feldhalterwerte können nicht angegebene IPv6-Quell- und Zieladressen sowie nicht angegebene Quell- und Zielports enthalten.

EnabledProtocolOffloads

Ein ULONG-Wert , der einen bitweisen OR von Flags enthält, die funktionen entsprechen, die der Miniporttreiber im SupportedProtocolOffloads-Member der NDIS_PM_CAPABILITIES-Struktur gemeldet hat. NDIS verwendet diese Flags, um die Protokollauslagerungsfunktionen mit geringer Leistung auf einem Netzwerkadapter zu aktivieren. Die folgenden Flags werden verwendet:

NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED

Wenn dieses Bit festgelegt ist, fordert der überlagernde Treiber den Netzwerkadapter an, um die ARP-Protokollauslagerungsfunktion zu aktivieren. Sobald diese Protokollauslagerung durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOAD konfiguriert wurde, sollte der Treiber den Netzwerkadapter in die Lage versetzen, auf IPv4-ARP-Pakete zu reagieren, während er sich in einem Energiesparzustand befindet.

NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED

Wenn dieses Bit festgelegt ist, fordert der überlagernde Treiber den Netzwerkadapter an, um die NS-Protokollauslagerungsfunktion (IPv6 Neighbor Solicitation) zu aktivieren. Sobald diese Protokollauslagerung durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOAD konfiguriert wurde, sollte der Treiber den Netzwerkadapter in die Lage versetzen, auf NS-Pakete zu reagieren, während er sich in einem Energiesparzustand befindet.

NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED

Wenn dieses Bit festgelegt ist, fordert der überlagernde Treiber den Netzwerkadapter an, um die RSN-Protokollauslagerungsfunktion (IEEE 802.11i Robust Security Network) zu aktivieren. Sobald diese Protokollauslagerung durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOAD konfiguriert wurde, sollte der Treiber den Netzwerkadapter in die Lage versetzen, auf RSN-Re-Key-Anforderungspakete zu reagieren, während er sich in einem Schwachstromzustand befindet.

WakeUpFlags

Ein ULONG-Wert, der ein bitweises OR mit NDIS_PM_WAKE_ON_ Xxx-Flags enthält. NDIS verwendet diese Flags, um Aktivierungsfunktionen für einen Netzwerkadapter zu aktivieren. Dieses Member verwendet die folgenden Flags:

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Reaktivierungsereignis zu generieren, wenn sich der Verbindungsstatus von "Medien getrennt" in "Verbundene Medien" ändert.

Weitere Informationen zu dieser WOL-Funktion finden Sie unter "Low Power on Media Disconnect".

NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Reaktivierungsereignis zu generieren, wenn sich der Linkstatus von Medien ändert, die verbunden sind, zu Medien, die getrennt sind.

NDIS_PM_SELECTIVE_SUSPEND_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn eines der folgenden Ereignisse auftritt:

  • Der Netzwerkadapter empfängt ein Paket, das einem Empfangspaketfilter entspricht. Der Adapter wird mit diesen Filtern über OID-Setanforderungen von OID_GEN_CURRENT_PACKET_FILTER konfiguriert.
  • Der Netzwerkadapter erkennt andere externe Ereignisse, die eine Verarbeitung durch den Netzwerktreiberstapel erfordern, z. B. wenn sich der Verbindungszustand in Medienverbindung oder verbundener Medien ändert.

Hinweis

Das NDIS_PM_SELECTIVE_SUSPEND_ENABLED-Flag ist in NDIS 6.30 und höher verfügbar.

Wenn dieses Flag festgelegt ist, können keine anderen Energieverwaltungsflags im WakeUpFlags-Member festgelegt werden, und der EnabledWoLPacketPatterns-Member muss auf 0 festgelegt werden.

Wenn NDIS das NDIS_PM_SELECTIVE_SUSPEND_ENABLED-Flag festlegt, wird die OID-Setanforderung von OID_PM_PARAMETERS direkt an den Miniporttreiber weitergeleitet. Dadurch kann NDIS die Verarbeitung durch Filtertreiber im Netzwerktreiberstapel umgehen.

Weitere Informationen zur Funktion zum selektiven Anhalten der Energieverwaltung finden Sie unter Selektives Anhalten von NDIS.

MediaSpecificWakeUpEvents

Ein ULONG-Wert , der ein bitweises OR von Flags enthält. Diese Flags geben die medienspezifischen Aktivierungsereignisse an, die ein Netzwerkadapter unterstützt.

Ab NDIS 6.30 werden die folgenden Flags definiert:

NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter 802.11 aktiviert, um ein Aktivierungsereignis zu generieren, wenn er einen Dienstsatzbezeichner (Service Set Identifier, SSID) erkennt, der über eine Netzwerkauslagerung (Network Offload, NLO) angegeben wurde.

Weitere Informationen zu NLO finden Sie unter WLAN-Network List Offload.

NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED

Wenn dieses Flag festgelegt ist, wird der 802.11-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er die Zuordnung zum Zugriffspunkt (Access Point, AP) nicht mehr aufweist.

NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED

Wenn dieses Flag festgelegt ist, wird der 802.11-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn während des IEEE 802.11i-GTK-Handshakes (RSN Group Transient Key) mit dem AP ein Fehler auftritt.

NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED

Wenn dieses Flag festgelegt ist, wird der 802.11-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er den ersten Frame des IEEE 802.11i RSN 4-Wege-Handshake mit dem AP empfängt. Dieser Handshake wird ausgeführt, wenn sich der Adapter beim AP authentifiziert.

NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED

Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter für mobiles Breitband (MB) aktiviert, um ein Aktivierungsereignis zu generieren, wenn sich sein Registrierungsstatus für den MB-Dienst geändert hat.

NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED

Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn der MB-Dienst über den Empfang einer SMS-Nachricht (Short Message Service) benachrichtigt werden muss. Der Adapter generiert dieses Aktivierungsereignis entweder nach Abschluss einer zuvor ausgestellten OID_WWAN_SMS_READ Abfrageanforderung oder nach dem Eintreffen einer neuen Class-0-Nachricht (Flash/Warnung) vom Netzwerkanbieter als Ereignisbenachrichtigung.

NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED

Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn er eine USSD-Nachricht (Unstructured Supplementary Service Data) empfängt.

NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED

Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn sich die Verfügbarkeit von Mobilfunkpaketdaten ändert. Dieses Flag ist neu in Windows 10.

NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED

Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Aktivierungsereignis zu generieren, wenn die UICC (SIM) Karte eingefügt, entfernt oder in einen Fehlerzustand versetzt wird. Dieses Flag ist neu in Windows 10.

Hinweise

Die NDIS_PM_PARAMETERS-Struktur gibt die aktivierten Hardwarefunktionen für die Energieverwaltung für die OID_PM_PARAMETERS OID an. Wenn die OID_PM_PARAMETERS OID abgefragt wird, stellt diese Struktur die aktuelle Energieverwaltungskonfiguration bereit. Wenn die OID_PM_PARAMETERS OID festgelegt ist, gibt diese Struktur eine neue Energieverwaltungskonfiguration an, die der Netzwerkadapter verwenden soll.

Ein Überlastungstreiber sollte nicht versuchen, Funktionen zu aktivieren, die ein Netzwerkadapter nicht unterstützt. Um einen überlastenden Treiber zu aktivieren, um zu bestimmen, welche Funktionen ein Netzwerkadapter bietet, stellt NDIS die Funktionen im PowerManagementCapabilitiesEx-Member der NDIS_BIND_PARAMETERS-Struktur bereit.

Hinweis

NDIS 6.20 und höher müssen das PowerManagementCapabilitiesEx-Element der NDIS_BIND_PARAMETERS-Struktur anstelle des PowerManagementCapabilities-Members verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.20 und höher.
Kopfzeile ntddndis.h (include Ntddndis.h)

Weitere Informationen

NDIS_BIND_PARAMETERS

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_PM_WOL_PATTERN

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS