Reporting Power Management-Funktionen

Miniport-Treiber, die NDIS 6.20 und höhere Versionen von NDIS unterstützen, melden ihre Hardware-Energieverwaltungsfunktionen während der Initialisierung. NDIS meldet die aktuellen Funktionen während des Bindungsvorgangs an überlastende NDIS-Protokolltreiber. NDIS kann jedoch einige Funktionen vor dem Protokolltreiber ausblenden. Beispielsweise kann NDIS unterschiedliche Funktionen melden, wenn ein Benutzer einige oder alle Energieverwaltungsfunktionen deaktiviert.

Beachten Sie, dass die aktuellen Energieverwaltungsfunktionen, die NDIS an einen Protokolltreiber meldet, nicht unbedingt mit den Hardwarefunktionen übereinstimmen, die der Miniporttreiber an NDIS gemeldet hat.

Wenn ein NDIS 6.1- oder früherer Miniporttreiber an einen NDIS 6.20-Protokolltreiber gebunden ist, übersetzt NDIS die Energieverwaltungsfunktionen in ein Format, das vom NDIS 6.20-Protokolltreiber unterstützt wird. NDIS übersetzt auch Energieverwaltungsfunktionen, die ein NDIS 6.20-Miniporttreiber meldet, in ein Format, das von NDIS 6.1 und früheren überlastenden Treibern unterstützt wird.

Die Hardwarefunktionen, die ein Miniporttreiber meldet, können in den INF-Dateieinstellungen aktiviert oder deaktiviert werden. Weitere Informationen zu Inf-Dateieinstellungen für die Energieverwaltung finden Sie unter Standardisierte INF-Schlüsselwörter für die Energieverwaltung.

Während der Miniportinitialisierung initialisiert ein Miniporttreiber eine NDIS_PM_CAPABILITIES-Struktur mit den Energieverwaltungsfunktionen der zugrunde liegenden Hardware. Der Miniporttreiber legt den PowerManagementCapabilitiesEx-Member der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur so fest, dass er auf die NDIS_PM_CAPABILITIES-Struktur verweist.

Die NDIS_PM_CAPABILITIES-Struktur enthält die folgenden Informationen:

Flags
Für NDIS 6.20 ist dieses Element für NDIS reserviert.

Ab NDIS 6.30 werden die folgenden Flags definiert:

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Wenn dieses Flag festgelegt ist, kann der Netzwerkadapter das empfangene Paket speichern, durch das der Adapter ein Aktivierungsereignis generiert hat.

Weitere Informationen zu dieser Energieverwaltungsfunktion finden Sie unter NDIS Wake Reason Status Indications( NDIS Wake Reason Status Indications).

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Wenn dieses Flag festgelegt ist, unterstützt der Miniporttreiber das selektive Anhalten von NDIS für Netzwerkadapter.

Weitere Informationen zu dieser Energieverwaltungsfunktion finden Sie unter Selektives Anhalten von NDIS.

SupportedWoLPacketPatterns
Enthält Flags, die die wake-on-LAN (WOL)-Paketmuster angeben, die von einem Netzwerkadapter unterstützt werden. Der Netzwerkadapter kann beispielsweise ein Aktivierungsereignis generieren, wenn er eine Bitmap, ein WOL-Magic-Paket oder eine EAPOL-Anforderungsbezeichnernachricht (EAP over LAN) empfängt. Eine vollständige Liste der Muster, die im aktuellen Betriebssystem unterstützt werden, finden Sie auf der Referenzseite NDIS_PM_CAPABILITIES .

NumTotalWoLPatterns
Ein ULONG-Wert , der die Gesamtanzahl von WOL-Mustern enthält, die von einem Netzwerkadapter unterstützt werden. Dies ist die Summe aus "Anzahl unterstützter WOL-Protokollmuster" und "Anzahl der unterstützten WOL-Bitmapmuster".

Wenn Ihr Treiber beispielsweise 8 flexible Bitmapmuster, IPv4 TCP SYN (über voreingestellten Filter) und Magic-Pakete unterstützt, würden Sie in NumTotalWoLPatterns den Wert 9 melden. (8 Bitmaps + 1 IPv4 TCP SYN = 9)

Hinweis Die Gesamtanzahl der WOL-Muster enthält nicht das Aktivierungsmuster des Magic-Pakets.

Weitere Informationen zu WOL-Protokollmustern finden Sie unter NDIS_PM_WOL_PATTERN.

MaxWoLPatternSize
Enthält die maximale Anzahl von Bytes, die mit einem Muster verglichen werden können.

MaxWoLPatternOffset
Enthält die Anzahl der Bytes in einem Paket, das untersucht werden kann, das am Anfang des MAC-Headers beginnt.

MaxWoLPacketSaveBuffer
Enthält die Anzahl der Bytes eines WOL-Protokollmusters, die ein Miniporttreiber in einem Puffer speichern und den Treiberstapel angeben kann.

SupportedProtocolOffloads
Enthält Flags, die die Von einem Netzwerkadapter unterstützten Auslagerungsfeatures für das Power Management-Protokoll angeben. Miniporttreiber verwenden diese Flags, um die Low Power Protocol Offload-Funktionen eines Netzwerkadapters zu melden. Der Netzwerkadapter kann z. B. IPv4-ARP-Auslagerung, IPv6 Neighbor Solicitation (NS) oder IEEE 802.11 robust secure network (RSN) 4-Wege- und 2-Wege-Handshake unterstützen. Eine vollständige Liste der Protokollauslagerungen, die im aktuellen Betriebssystem unterstützt werden, finden Sie auf der Referenzseite NDIS_PM_CAPABILITIES .

NumArpOffloadIPv4Addresses
Enthält die Anzahl der IPv4-Adressen für die ARP-Auslagerung.

NumnsOffloadIPv6Addresses
Enthält die Anzahl der vom Netzwerkadapter unterstützten IPv6-Anforderungen (Network Solicitation, NS).

MinMagicPacketWakeUp
Gibt den niedrigsten Geräteleistungszustand an, aus dem ein Netzwerkadapter beim Empfang eines Magic-Pakets ein Aktivierungsereignis signalisieren kann. (Ein Magic-Paket ist ein Paket, das 16 zusammenhängende Kopien der Ethernet-Adresse des empfangenden Netzwerkadapters enthält.)

MinPatternWakeUp
Gibt den niedrigsten Geräteleistungszustand an, von dem aus ein Netzwerkadapter beim Empfang eines Netzwerkframes ein Aktivierungsereignis signalisieren kann, das ein vom Protokolltreiber angegebenes Muster enthält.

MinLinkChangeWakeUp
Gibt den niedrigsten Geräteleistungszustand an, von dem aus ein Netzwerkadapter ein Aktivierungsereignis signalisieren kann, wenn eine Linkänderung erfolgt (Medienverbindung oder Trennen).

SupportedWakeUpEvents
Gibt die medienunabhängigen Aktivierungsereignisse an, die von einem Netzwerkadapter unterstützt werden. Diese Ereignisse sind nicht spezifisch für den Medientyp. Zu diesen Aktivierungsereignissen gehören beispielsweise Linkänderungsereignisse.

MediaSpecificWakeUpEvents
Gibt die medienspezifischen Aktivierungsereignisse an, die von einem Netzwerkadapter unterstützt werden. Zu diesen Ereignissen gehören z. B. die folgenden:

• Der 802.11-Netzwerkadapter wird dem Zugriffspunkt (Access Point, AP) zugeordnet.

• Der Netzwerkadapter für mobiles Breitband (MB) erkennt eine Änderung des Registrierungsstatus für den MB-Dienst.

Wenn ein Miniporttreiber das Auslagern von Protokollen an einen Netzwerkadapter in einem energiesparenden Zustand unterstützt, muss er denselben Low Power-Zustand für die Protokollauslagerung unterstützen, den er für ein WOL-Ereignis mit Musterabgleich unterstützt. d. h. der Wert, der im Element MinPatternWakeUp oder MinMagicPacketWakeUp angegeben wird.

NDIS initialisiert eine NDIS_PM_CAPABILITIES-Struktur mit den derzeit verfügbaren Energieverwaltungsfunktionen des zugrunde liegenden Netzwerkadapters und übergibt sie während des Bindungsvorgangs an die protokollüberlastenden Protokolltreiber. NDIS legt den PowerManagementCapabilitiesEx-Member der NDIS_BIND_PARAMETERS-Struktur so fest, dass er auf die NDIS_PM_CAPABILITIES-Struktur verweist.

Überlastende Treiber können die OID_PM_HARDWARE_CAPABILITIES OID-Abfrage verwenden, um die Hardware-Energieverwaltungsfunktionen des Netzwerkadapters abzurufen. NDIS verarbeitet diese OID-Anforderung im Namen des Miniporttreibers. NDIS-Miniporttreiber sind nicht erforderlich, um die OID_PM_HARDWARE_CAPABILITIES OID-Anforderung zu unterstützen.

Überlastende Treiber können die OID_PM_CURRENT_CAPABILITIES OID verwenden, um die derzeit verfügbaren Energieverwaltungsfunktionen eines Netzwerkadapters abzufragen. NDIS verarbeitet diese OID-Anforderung im Namen des Miniporttreibers. NDIS-Miniporttreiber sind nicht erforderlich, um die OID_PM_CURRENT_CAPABILITIES OID-Anforderung zu unterstützen.