Standardisierte INF-Schlüsselwörter für Power Management

Die standardisierten Schlüsselwörter (Keywords) werden in der INF-Datei des Gerätetreibers definiert. Das Betriebssystem liest diese standardisierten Schlüsselwörter (Keywords) und passt die aktuellen Leistungsverwaltungsfunktionen des Geräts an.

Sowohl Netzwerkadapter-WDF-Klassenerweiterungstreiber (NetAdapterCx) als auch herkömmliche NDIS-Miniportgerätetreiber verwenden diese Schlüsselwörter (Keywords) für die Energieverwaltung . Einige Schlüsselwörter (Keywords) werden jedoch ausschließlich von NetAdapterCx-Treibern verwendet, während andere ausschließlich von NDIS-Treibern verwendet werden, wie in den folgenden Abschnitten beschrieben:

Der herkömmliche NDIS Miniport-Gerätetreiber sollte immer die Hardwareleistungsverwaltungsfunktionen des Geräts in der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur auf NDIS hinweisen.

Weitere Informationen zu standardisierten INF-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.

Leistungsverwaltungs-Schlüsselwörter für NetAdapterCx und NDIS

Die folgenden standardisierten INF-Schlüsselwwörter sind definiert, um die Unterstützung für die Energieverwaltungsfunktionen von Netzwerkadaptern zu aktivieren oder zu deaktivieren. Sie werden sowohl von NetAdapterCx-Clienttreibern als auch von herkömmlichen NDIS-Miniport-Gerätetreibern verwendet.

*WakeOnPattern
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um den Computer zu reaktivieren, wenn ein Netzwerkpaket mit einem angegebenen Muster übereinstimmt.

*WakeOnMagicPacket
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um den Computer zu reaktivieren, wenn das Gerät ein magisches Paket empfängt. (Ein magisches Paket ist ein Paket, das 16 zusammenhängende Kopien der Ethernet-Adresse des empfangenden Netzwerkadapters enthält)

*PMARPOffload
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um das Adressauflösungsprotokoll (Address Resolution Protocol, ARP) auszuschalten, wenn das System in den Ruhezustand wechselt.

*PMNSOffload
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um die benachbarten Anforderungen (NS) zu entladen, wenn das System in den Ruhezustand wechselt.

*PMWiFiRekeyOffload
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um die Neukodierung des Group Temporary Key (GTK) für Wake-on-Wireless-LAN (WOL) auszulagern, wenn der Computer in den Ruhezustand wechselt.

*EEE
Ein Wert, der beschreibt, ob das Gerät IEEE 802.3az Energy-Efficient Ethernet aktivieren soll.

Die Spalten in der Tabelle am Ende dieses Themas beschreiben die folgenden Attribute für Enumerationsschlüsselwörter:

Name des Unterschlüssels
Der Name der Schlüsselworts, die Sie in der INF-Datei angeben müssen und die in der Registrierung angezeigt wird.

ParamDesc
Der Anzeigetext, der mit "SubkeyName" verknüpft ist.

Wert
Der ganzzahlige Enumerationswert, der jeder Option in der Liste zugeordnet ist. Dieser Wert wird in NDI\params\SubkeyName\Value gespeichert

EnumDesc
Der Anzeigetext, der jedem Wert zugeordnet ist, der im Menü angezeigt wird.

In der folgenden Tabelle werden die möglichen INF-Einträge für die Energieverwaltungs-Schlüsselwörter, die von NDIS- und NetAdapterCx-Treibern verwendet werden, beschrieben.

Name des Unterschlüssels ParamDesc Wert EnumDesc
*WakeOnPattern Aufwachen bei Musterübereinstimmung 0 Disabled
1 (Standard) Aktiviert
*WakeOnMagicPacket Aufwachen mit Magic-Paket 0 Disabled
1 (Standard) Aktiviert
*PMARPOffload ARP-Auslagerung 0 Disabled
1 (Standard) Aktiviert
*PMNSOffload NS-Abladung 0 Disabled
1 (Standard) Aktiviert
*PMWiFiRekeyOffload WiFi-Neuschlüsselungs-Auslagerung 0 Disabled
1 (Standard) Aktiviert
*EEE Energieeffizientes Ethernet 0 Disabled
1 (Standard) Aktiviert

Leistungsverwaltungs-Schlüsselwörter exklusiv für NetAdapterCx

Die folgenden Power Management-Schlüsselwörter gelten nur für netAdapterCx-Clienttreiber.

Zusätzlich zum standardmäßigen WDF-Prozess, der dem Benutzer die Kontrolle über das Leerlauf- und Wachverhalten des Geräts gibt, wie in der Benutzersteuerung des Leerlauf- und Wachverhaltens des Geräts beschrieben, definiert NetAdapterCx auch ein netzwerkgerätespezifisches standardisiertes INF-Schlüsselwort, um mehr Kontrolle zu ermöglichen.

*IdleRestriction
Wenn ein Netzwerkgerät sowohl leerlauf- als auch reaktive Funktionen zum Aktivieren von Paketfiltern enthält, kann der Benutzer entscheiden, wann der Leerlauf des Geräts ausgeführt werden kann.

*IdleRestriction ist ein enumerationsstandardisierte INF-Schlüsselwort und weist die folgenden Attribute auf:

In der folgenden Tabelle werden die möglichen INF-Einträge für das *IdleRestriction-Schlüsselwort beschrieben.

Name des Unterschlüssels ParamDesc Wert EnumDesc
*IdleRestriction Ausschaltbeschränkung im Leerlauf 0 (Standard) Keine Einschränkung
1 Nur im Leerlauf, wenn der Benutzer nicht anwesend ist

Leistungsverwaltung-Schlüsselwörter exklusiv für NDIS

Die folgenden Energieverwaltungs-Schlüsselwörter gelten nur für herkömmliche NDIS-Miniporttreiber. Sie dürfen nicht von NetAdapterCx-Clienttreibern verwendet werden.

*ModernStandbyWoLMagicPacket
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um den Computer zu reaktivieren, wenn das Gerät ein magisches Paket empfängt und das System sich im S0ix-Energiezustand befindet. Dies gilt nicht, wenn sich das System im S4-Energiezustand befindet.

Hinweis

*ModernStandbyWoLMagicPacket wird in NDIS 6.60 und höher oder Windows 10, Version 1607 und höher, unterstützt.

*DeviceSleepOnDisconnect
Ein Wert, der beschreibt, ob das Gerät aktiviert werden soll, um es in einen Energiesparzustand (Ruhezustand) zu versetzen, wenn das Medium getrennt wird, und in einen Zustand mit voller Leistung (Wake-Zustand) zurückzukehren, wenn das Medium erneut angeschlossen wird.

In der folgenden Tabelle werden die möglichen INF-Einträge für die Energieverwaltungsschlüsselwörter beschrieben, die von NDIS-Miniporttreibern verwendet werden.

Name des Unterschlüssels ParamDesc Wert EnumDesc
*ModernStandbyWoLMagicPacket Wake-on-Magic-Packet, wenn sich das System im Energiezustand S0ix befindet 0 (Standard) Disabled
1 Aktiviert
*DeviceSleepOnDisconnect Gerätestandby beim Trennen 0 Disabled
1 (Standard) Aktiviert