Freigeben über

Standardisierte INF-Schlüsselwörter für die Energieverwaltung

  • Artikel

Die standardisierten Schlüsselwörter für die Energieverwaltung werden in der Setupinformationsdatei des Gerätetreibers (INF) definiert. Das Betriebssystem liest diese standardisierten Schlüsselwörter 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 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.

Schlüsselwörter für die Energieverwaltung für NetAdapterCx und NDIS

Die folgenden standardisierten INF-Schlüsselwörter werden definiert, um die Unterstützung für Energieverwaltungsfeatures 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 aufzuwecken, 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 energieeffizientes Ethernet aktivieren soll.

Die Spalten in der Tabelle am Ende dieses Artikels beschreiben die folgenden Attribute für Enumerationsstichwörter:

  • Unterschlüsselname: Der Name des Schlüsselworts, das Sie in der INF-Datei angeben müssen und das in der Registrierung angezeigt wird.

  • ParamDesc: Der Anzeigetext, der mit dem SubkeyName verbunden ist.

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

  • EnumDesc: Der Anzeigetext, der den einzelnen Werten zugeordnet ist, die im Menü angezeigt werden.

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

Unterschlüsselname 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 WLAN-Neuschlüsselungs-Auslagerung 0 Disabled
1 (Standard) Aktiviert
*EEE Energieeffizientes Ethernet 0 Disabled
1 (Standard) Aktiviert

Schlüsselwörter zur Energieverwaltung exklusiv für NetAdapterCx

Das folgenden Power Management-Schlüsselwort gilt 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 standardisiertes Enumeration-INF-Schlüsselwort. In der folgenden Tabelle werden die möglichen INF-Einträge für das schlüsselwort *IdleRestriction beschrieben.

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

Schlüsselwörter für die Energieverwaltung, die ausschließlich für NDIS gelten

Die folgenden Schlüsselwörter für die Energieverwaltung 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.

Anmerkung

*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 von NDIS-Miniporttreibern verwendeten Energieverwaltungs-Schlüsselwörter beschrieben.

Unterschlüsselname 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