Standardisierte INF-Schlüsselwörter für das selektive Anhalten von NDIS
Hinweis
Schlüsselwörter im Zusammenhang mit selektivem Anhalten gelten nur für die herkömmliche Verwendung des NDIS-Miniporttreibers. Sie sind in der Netzwerkadapter-WDF-Klassenerweiterung (NetAdapterCx) veraltet und dürfen nicht von ihren Clienttreibern verwendet werden.
Die folgenden standardisierten INF-Schlüsselwörter werden definiert, um Parameter für das selektive Anhalten von NDIS auf einem Miniporttreiber zu aktivieren, zu deaktivieren und zu konfigurieren:
*SelectiveSuspend INF-Schlüsselwort
*SSIdleTimeout INF-Schlüsselwort
*SSIdleTimeoutScreenOff INF-Schlüsselwort
Weitere Informationen zu standardisierten INF-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.
*SelectiveSuspend INF-Schlüsselwort
Die INF-Datei für den Miniporttreiber, der das selektive Anhalten von NDIS unterstützt, muss die standardisierte *SelectiveSuspend-INF-Schlüsselwort (keyword) angeben. Nach der Installation des Treibers können Administratoren den Wert *SelectiveSuspend Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Netzwerkadapter aktualisieren. Weitere Informationen zu erweiterten Eigenschaften finden Sie unter Angeben von Konfigurationsparametern für die Seite Erweiterte Eigenschaften.
Hinweis Der Miniporttreiber wird automatisch neu gestartet, nachdem eine Änderung auf der Eigenschaftenseite Erweitert für den Adapter vorgenommen wurde.
Die *SelectiveSuspend INF-Schlüsselwort (keyword) ist eine Enumeration Schlüsselwort (keyword). In der folgenden Tabelle werden die möglichen INF-Einträge für die *SelectiveSuspend INF-Schlüsselwort (keyword) beschrieben. Die Spalten in dieser Tabelle beschreiben die folgenden Attribute für eine Enumeration Schlüsselwort (keyword):
Name des Unterschlüssels
Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen. Dieser Name wird auch in der Registrierung unter dem Schlüssel NDI\params\ für den Netzwerkadapter angezeigt.
ParamDesc
Der Anzeigetext, der SubkeyName zugeordnet ist.
Hinweis Der unabhängige Hardwarehersteller (Independent Hardware Vendor, IHV) kann jeden beschreibenden Text für den SubkeyName definieren.
Wert
Der ganzzahlige Enumerationswert, der jedem SubkeyName in der Liste zugeordnet ist.
EnumDesc
Der Anzeigetext, der jedem Wert zugeordnet ist, der auf der Eigenschaftenseite Erweitert angezeigt wird.
| Name des Unterschlüssels | ParamDesc | Wert | EnumDesc |
|---|---|---|---|
*SelectiveSuspend |
Selektives Anhalten |
0 |
Disabled |
1 (Standard) |
Aktiviert |
Der Miniporttreiber muss den Wert *SelectiveSuspend Schlüsselwort (keyword) in der Registrierung überprüfen, bevor er seine Unterstützung für das selektive Anhalten von NDIS angibt. Wenn die *SelectiveSuspend-Schlüsselwort (keyword) den Wert 0 hat, darf der Miniport keine Unterstützung für funktionen zum selektiven Anhalten ankündigen. Weitere Informationen finden Sie unter Reporting NDIS Selective Suspend Capabilities( Reporting NDIS Selective Suspend Capabilities).
*SSIdleTimeout INF-Schlüsselwort
Die INF-Datei für den Miniporttreiber, der das selektive Anhalten von NDIS unterstützt, sollte die optionale standardisierte *SSIdleTimeout-INF-Schlüsselwort (keyword) angeben. Dieser Schlüsselwort (keyword) gibt den Leerlauftimeoutzeitraum in Sekundeneinheiten an. Wenn NDIS für einen Zeitraum, der den *SSIdleTimeout-Wert überschreitet, keine Aktivität auf dem Netzwerkadapter erkennt, startet NDIS einen selektiven Anhaltevorgang, indem die MiniportIdleNotification-Handlerfunktion des MiniportIdleNotification-Treibers aufgerufen wird.
Nachdem der Treiber installiert wurde, können Administratoren den Wert *SSIdleTimeout Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Netzwerkadapter aktualisieren. Weitere Informationen zu erweiterten Eigenschaften finden Sie unter Angeben von Konfigurationsparametern für die Seite Erweiterte Eigenschaften.
Hinweis Der Miniporttreiber wird automatisch neu gestartet, nachdem auf der Erweiterten Eigenschaftenseite für den Adapter eine Änderung vorgenommen wurde.
Die *SSIdleTimeout INF-Schlüsselwort (keyword) ist ein numerisches (Int)-Schlüsselwort (keyword). In der folgenden Tabelle werden die möglichen INF-Einträge für die *SSIdleTimeout INF-Schlüsselwort (keyword) beschrieben. Die Spalten in der Tabelle beschreiben die folgenden Attribute für eine Int-Schlüsselwort (keyword):
Name des Unterschlüssels
Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen. Dieser Name wird auch in der Registrierung unter dem Schlüssel NDI\params\ für den Netzwerkadapter angezeigt.
ParamDesc
Der Anzeigetext, der SubkeyName zugeordnet ist.
Hinweis Der unabhängige Hardwarehersteller (Independent Hardware Vendor, IHV) kann jeden beschreibenden Text für den SubkeyName definieren.
Standardwert
Der Standardwert für die ganze Zahl.
Mindestwert
Der Mindestwert, der für eine ganze Zahl zulässig ist.
Maximalwert
Der maximal zulässige Wert für eine ganze Zahl.
| Name des Unterschlüssels | ParamDesc | Standardwert | Minimalwert | Maximalwert |
|---|---|---|---|---|
*SSIdleTimeout |
Timeout für selektives Anhalten im Leerlauf in Sekundeneinheiten |
5 |
1 |
60 |
Hinweis NDIS liest den Wert der standardisierten *SSIdleTimeout-INF-Schlüsselwort (keyword) für jede instance des Netzwerkadapters, dessen Treiber das selektive Anhalten von NDIS unterstützt. Miniport-Treiber sollten diese Schlüsselwort (keyword) nicht lesen.
NDIS misst das Leerlauftimeout mithilfe von Timern, die innerhalb von 30 Prozent des *SSIdleTimeout-Werts liegen. Wenn der Wert *SSIdleTimeout beispielsweise 10 ist, wird der Adapter zwischen 10 und 13 Sekunden angehalten, nachdem NDIS zum ersten Mal erkannt hat, dass sich der Adapter im Leerlauf befindet.
*SSIdleTimeoutScreenOff INF-Schlüsselwort
Die INF-Datei für den Miniporttreiber, der das selektive Anhalten von NDIS unterstützt, sollte die optionale standardisierte *SSIdleTimeoutScreenOff-inF-Schlüsselwort (keyword) angeben. Dieser Schlüsselwort (keyword) gibt den Leerlauftimeoutzeitraum in Sekundeneinheiten an und gilt nur, wenn der Bildschirm ausgeschaltet ist. Wenn NDIS für einen Zeitraum, der den *SSIdleTimeoutScreenOff-Wert überschreitet, keine Aktivität auf dem Netzwerkadapter erkennt, nachdem der Bildschirm ausgeschaltet ist, startet NDIS einen selektiven Anhaltevorgang, indem die MiniportIdleNotification-Handlerfunktion des MiniportIdleNotification-Treibers aufgerufen wird.
Nach der Installation des Treibers können Administratoren den Wert *SSIdleTimeoutScreenOff Schlüsselwort (keyword) auf der Eigenschaftenseite Erweitert für den Netzwerkadapter aktualisieren. Weitere Informationen zu erweiterten Eigenschaften finden Sie unter Angeben von Konfigurationsparametern für die Seite Erweiterte Eigenschaften.
Hinweis Der Miniporttreiber wird automatisch neu gestartet, nachdem auf der Erweiterten Eigenschaftenseite für den Adapter eine Änderung vorgenommen wurde.
Die *SSIdleTimeoutScreenOff INF-Schlüsselwort (keyword) ist eine numerische (Int)-Schlüsselwort (keyword). In der folgenden Tabelle werden die möglichen INF-Einträge für die *SSIdleTimeoutScreenOff-INF-Schlüsselwort (keyword) beschrieben. Die Spalten in der Tabelle beschreiben die folgenden Attribute für eine Int-Schlüsselwort (keyword):
Name des Unterschlüssels
Der Name des Schlüsselwort (keyword), den Sie in der INF-Datei angeben müssen. Dieser Name wird auch in der Registrierung unter dem Schlüssel NDI\params\ für den Netzwerkadapter angezeigt.
ParamDesc
Der Anzeigetext, der SubkeyName zugeordnet ist.
Hinweis Der unabhängige Hardwarehersteller (Independent Hardware Vendor, IHV) kann jeden beschreibenden Text für den SubkeyName definieren.
Standardwert
Der Standardwert für die ganze Zahl.
Mindestwert
Der Mindestwert, der für eine ganze Zahl zulässig ist.
Maximalwert
Der maximal zulässige Wert für eine ganze Zahl.
| Name des Unterschlüssels | ParamDesc | Standardwert | Minimalwert | Maximalwert |
|---|---|---|---|---|
*SSIdleTimeoutScreenOff |
Timeout für selektives Anhalten im Leerlauf in Sekundeneinheiten |
3 |
1 |
60 |
Hinweis NDIS liest den Wert der standardisierten *SSIdleTimeoutScreenOff-INF-Schlüsselwort (keyword) für jede instance des Netzwerkadapters, dessen Treiber das selektive Anhalten von NDIS unterstützt. Miniport-Treiber sollten diese Schlüsselwort (keyword) nicht lesen.
Hinweis Der Maximalwert ist nur zu Testzwecken. Der HLK-Zertifizierungstest überprüft explizit und schlägt fehl, wenn der Wert größer als 5 ist.
NDIS misst das Leerlauftimeout mithilfe von Timern, die genau auf 30 Prozent des *SSIdleTimeoutScreenOff-Werts liegen. Wenn der Wert *SSIdleTimeoutScreenOff beispielsweise 5 ist, wird der Adapter zwischen 5 und 6,5 Sekunden angehalten, nachdem NDIS zum ersten Mal erkannt hat, dass sich der Adapter im Leerlauf befindet.