NDIS_PM_PARAMETERS Struktur (ntddndis.h)
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;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der NDIS_PM_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.
Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_PM_PARAMETERS-Struktur anzugeben, muss der Treiber das element RevisionHeader- auf den folgenden Wert festlegen:
NDIS_PM_PARAMETERS_REVISION_2
Verschiedene Änderungen für NDIS 6.30 wurden hinzugefügt.
Legen Sie das element Size auf NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2 fest.
NDIS_PM_PARAMETERS_REVISION_1
Originalversion 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 ein bitweises ODER von Flags enthält, die funktionen entsprechen, die der miniport-Treiber in der SupportedWoLPacketPatterns Member der NDIS_PM_CAPABILITIES-Struktur gemeldet hat. NDIS verwendet diese Flags, um die Wake-on-LAN (WOL)-Muster zu aktivieren, die ein Netzwerkadapter verwendet, um den lokalen Computer aus einem Energiesparzustand 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 Wake-up-Ereignis zu generieren, wenn es 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 Wake-up-Ereignis zu generieren, wenn es ein WOL Magic-Paket empfängt. Ein Magisches Paket enthält innerhalb seiner Nutzlast eine Zeichenfolge von sechs Bytes mit dem Wert 0xFF, gefolgt von 16 zusammenhängenden Kopien der Medienzugriffssteuerungsadresse (MEDIA Access Control, MAC) des empfangenden Netzwerkadapters.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn es eine EAPOL-Anforderungs-ID-Nachricht empfängt.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn es 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 Wake-up-Ereignis zu generieren, wenn es ein IPv6 TCP SYN-Paket empfängt.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Wenn dieses Flag festgelegt ist, muss der Netzwerkadapter als Wildcard- Werte beliebige nullgefüllte Werte oder nicht spezifizierten, Werte für IPv4-Adressen und TCP/UDP-Ports in einem WOL-Muster 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 Wake-up-Ereignis 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 Wildcardwert 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 Ungleichwert enthält, der dem Wert des Pakets entspricht.
Anmerkung
Die durch dieses Flag aktivierten Wildcardwerte 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 als Wildcard- Werte von null gefüllten Werten oder nicht spezifizierten, Werte für IPv6-Adressen und TCP/UDP-Ports in einem WOL-Muster behandeln. Auf diese Weise entspricht der Wildcardwert 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 Wake-up-Ereignis 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 Wildcardwert 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 Ungleichwert enthält, der dem Wert des Pakets entspricht.
Anmerkung
Durch dieses Flag aktivierte Wildcardwerte können nicht angegebene IPv6-Quell- und Zieladressen sowie nicht angegebene Quell- und Zielports enthalten.
EnabledProtocolOffloads
Ein ULONG--Wert, der ein bitweises ODER von Flags enthält, die funktionen entsprechen, die der miniport-Treiber in der SupportedProtocolOffloads Member der NDIS_PM_CAPABILITIES Struktur gemeldet hat. NDIS verwendet diese Flags, um die Offload-Funktionen des Low-Power-Protokolls 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-Protokoll offload-Funktion zu aktivieren. Sobald dieses Protokoll offload durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOADkonfiguriert wurde, sollte der Treiber den Netzwerkadapter aktivieren, um auf IPv4-ARP-Pakete zu reagieren, während es 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 Offloadfunktion des IPv6 Neighbor Solicitation (NS)-Protokolls zu aktivieren. Sobald dieses Protokoll offload durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOADkonfiguriert wurde, sollte der Treiber den Netzwerkadapter aktivieren, um auf NS-Pakete zu reagieren, während es 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 IEEE 802.11i Robust Security Network (RSN)-Protokoll offload-Funktion zu aktivieren. Sobald dieses Protokoll offload durch eine festgelegte Anforderung von OID_PM_ADD_PROTOCOL_OFFLOADkonfiguriert wurde, sollte der Treiber den Netzwerkadapter aktivieren, um auf RSN-Neuschlüsselanforderungen an Pakete zu reagieren, während es sich im Energiesparmodus befindet.
WakeUpFlags
Ein ULONG-Wert, der ein bitweises OR von NDIS_PM_WAKE_ON_ Xxx- Flags enthält. NDIS verwendet diese Flags, um Wake-up-Funktionen auf einem Netzwerkadapter zu aktivieren. Dieses Mitglied verwendet die folgenden Flags:
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Wenn dieses Kennzeichen festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn sich der Verbindungsstatus von Medien ändert, die mit dem verbundenen Medium verbunden sind.
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 Wake-up-Ereignis zu generieren, wenn sich der Verbindungsstatus von Medien ändert, die mit Medien verbunden sind.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter aktiviert, um ein Wake-up-Ereignis 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-Set-Anforderungen von OID_GEN_CURRENT_PACKET_FILTERkonfiguriert.
- Der Netzwerkadapter erkennt andere externe Ereignisse, die eine Verarbeitung durch den Netzwerktreiberstapel erfordern, z. B. wenn sich der Verbindungszustand in die Medienverbindung ändert oder Medien verbunden sind.
Anmerkung
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 die EnabledWoLPacketPatterns Member muss auf Null festgelegt werden.
Wenn NDIS das NDIS_PM_SELECTIVE_SUSPEND_ENABLED-Kennzeichen festlegt, gibt es die OID-Setanforderung von OID_PM_PARAMETERS direkt an den Miniporttreiber aus. Auf diese Weise kann NDIS die Verarbeitung durch Filtertreiber im Netzwerktreiberstapel umgehen.
Weitere Informationen zur funktion zur selektiven Energieverwaltung für Anhalteanlagen finden Sie unter NDIS Selektives Anhalten.
MediaSpecificWakeUpEvents
Ein ULONG--Wert, der ein bitweises ODER- von Flags enthält. Diese Flags geben die medienspezifischen Wake-up-Ereignisse 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 Wake-up-Ereignis zu generieren, wenn ein Dienstsatzbezeichner (Service Set Identifier, SSID) erkannt wird, der über ein Netzwerk offload (NLO) angegeben wurde.
Weitere Informationen zu NLO finden Sie unter Wi-Fi Netzwerklisten offload.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Wenn dieses Flag festgelegt ist, ist der 802.11-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn es die Zuordnung zum Zugriffspunkt (AP) aufheben wird.
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Wenn dieses Flag festgelegt ist, wird der Netzwerkadapter 802.11 aktiviert, um ein Wake-up-Ereignis zu generieren, wenn während des IEEE 802.11i RSN-Gruppen-Transientenschlüssels (GTK) ein Fehler mit der AP auftritt.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Wenn dieses Flag festgelegt ist, wird der 802.11-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn er den ersten Frame des IEEE 802.11i RSN 4-Wege-Handshakes mit der AP empfängt. Dieser Handshake wird ausgeführt, wenn sich der Adapter bei der 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 Wake-up-Ereignis zu generieren, wenn sich der Registrierungsstatus für den MB-Dienst geändert hat.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Wenn dieses Kennzeichen festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn der MB-Dienst über den Empfang einer SMS-Nachricht (Short Message Service) benachrichtigt werden muss. Der Adapter generiert dieses Reaktivierungsereignis entweder nach Abschluss einer zuvor ausgestellten OID_WWAN_SMS_READ Abfrageanforderung oder das Eintreffen einer neuen Class-0-Nachricht (Flash/Alert) des Netzwerkanbieters als Ereignisbenachrichtigung.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn es eine UNstructured Supplementary Service Data (USSD)-Nachricht empfängt.
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Wenn dieses Flag festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn sich die Verfügbarkeit von Daten des Mobilfunkpakets ändert. Dieses Kennzeichen ist neu in Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Wenn dieses Kennzeichen festgelegt ist, wird der MB-Netzwerkadapter aktiviert, um ein Wake-up-Ereignis zu generieren, wenn die UICC-Karte (SIM)-Karte eingefügt, entfernt oder in einen Fehlerzustand wechselt. Dieses Kennzeichen ist neu in Windows 10.
Bemerkungen
Die NDIS_PM_PARAMETERS-Struktur gibt die aktivierten Power Management-Hardwarefunktionen für das 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 übermäßiger Treiber sollte nicht versuchen, Funktionen zu aktivieren, die von einem Netzwerkadapter nicht unterstützt werden. Um einen übermäßigen Treiber zu ermöglichen, um zu bestimmen, welche Funktionen ein Netzwerkadapter bereitstellt, stellt NDIS die Funktionen im PowerManagementCapabilitiesEx Member der NDIS_BIND_PARAMETERS-Struktur bereit.
Anmerkung
NDIS 6.20 und höhere Treiber müssen das PowerManagementCapabilitiesEx- Mitglied der NDIS_BIND_PARAMETERS-Struktur anstelle des PowerManagementCapabilities Mitglieds verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.20 und höher. |
| Header- | ntddndis.h (include Ntddndis.h) |