Możliwości raportowania zarządzania energią

Sterowniki Miniport, które obsługują usługę NDIS 6.20 i nowsze wersje NDIS, zgłaszają swoje możliwości zarządzania energią sprzętową podczas inicjowania. Usługa NDIS zgłasza bieżące parametry nadrzędnych sterowników protokołów NDIS podczas operacji powiązania. Jednak usługa NDIS może ukryć niektóre możliwości sterownika protokołu. Na przykład usługa NDIS może zgłaszać różne możliwości, gdy użytkownik wyłączy niektóre lub wszystkie możliwości zarządzania energią.

Należy pamiętać, że bieżące możliwości zarządzania energią, które NDIS zgłaszają do sterownika protokołu, nie muszą być takie same jak możliwości sprzętowe, które sterownik miniportu zgłosił do usługi NDIS.

Jeśli miniport sterownika NDIS 6.1 lub starszego jest powiązany ze sterownikiem protokołu NDIS 6.20, NDIS przekłada możliwości zarządzania energią na format obsługiwany przez sterownik protokołu NDIS 6.20. Usługa NDIS również przekłada możliwości zarządzania energią, które zgłasza sterownik miniportu NDIS 6.20, na format obsługiwany przez sterowniki nadrzędne NDIS 6.1 i starsze.

Możliwości sprzętowe, które zgłasza sterownik miniportu, mogą być włączone lub wyłączone w ustawieniach plików INF. Aby uzyskać więcej informacji na temat ustawień plików INF zarządzania energią, zobacz ustandaryzowane słowa kluczowe INF do zarządzania energią.

Podczas inicjowania miniportu sterownik miniportu inicjuje strukturę NDIS_PM_CAPABILITIES z możliwościami zarządzania energią podstawowego sprzętu. Sterownik miniportu ustawia składową PowerManagementCapabilitiesEx struktury NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, aby wskazywała na strukturę NDIS_PM_CAPABILITIES.

Struktura NDIS_PM_CAPABILITIES zawiera następujące informacje:

Flagi
Dla NDIS 6.20 ten element jest zarezerwowany dla NDIS.

Począwszy od NDIS 6.30, zdefiniowane są następujące flagi:

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Jeśli ta flaga jest ustawiona, karta sieciowa może zapisać odebrany pakiet, który spowodował zdarzenie wybudzenia generowane przez kartę.

Aby uzyskać więcej informacji na temat tej możliwości zarządzania energią, zobacz Wskaźniki statusu przyczyny wybudzenia NDIS.

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Jeśli ta flaga jest ustawiona, sterownik miniportu obsługuje NDIS Selective Suspend dla kart sieciowych.

Aby uzyskać więcej informacji na temat tej funkcji zarządzania energią, zobacz NDIS Selective Suspend.

SupportedWoLPacketPatterns
Zawiera flagi określające wzorce pakietów wake-on-LAN (WOL), które karta sieciowa obsługuje. Na przykład karta sieciowa może wygenerować zdarzenie wybudzające po odebraniu bitmapy, pakietu magicznego WOL lub komunikatu o identyfikatorze żądania EAP over LAN (EAPOL). Aby uzyskać pełną listę wzorców obsługiwanych w bieżącym systemie operacyjnym, zobacz stronę referencyjną NDIS_PM_CAPABILITIES.

NumTotalWoLPatterns
Wartość ULONG zawierająca całkowitą liczbę wzorców WOL, które obsługuje karta sieciowa. Jest to suma "liczby obsługiwanych wzorców protokołu WOL" i "liczba obsługiwanych wzorców map bitowych WOL".

Jeśli na przykład sterownik obsługuje 8 elastycznych wzorców map bitowych, protokół IPv4 TCP SYN (za pośrednictwem filtru wstępnego) i pakiet magiczny, raportuje się 9 w NumTotalWoLPatterns. (8 bitmap + 1 SYN TCP IPv4 = 9)

Uwaga Całkowita liczba wzorców WOL nie obejmuje wzorca wybudzania za pomocą magicznego pakietu.

Aby uzyskać więcej informacji na temat wzorców protokołu WOL, zobacz NDIS_PM_WOL_PATTERN.

MaxWoLPatternSize
Zawiera maksymalną liczbę bajtów, które można porównać ze wzorcem.

MaxWoLPatternOffset
Zawiera liczbę bajtów w pakiecie, który można zbadać, który zaczyna się od początku nagłówka MAC.

MaxWoLPacketSaveBuffer
Zawiera liczbę bajtów wzorca protokołu WOL, który sterownik miniportu może zapisać w buforze i wskazać stos sterowników.

Obsługiwane Protokoły Wyładowań
Zawiera flagi określające funkcje rozładowywania protokołu zarządzania energią obsługiwane przez kartę sieciową. Sterowniki Miniport używają tych flag do raportowania możliwości odciążenia protokołu o niskim zużyciu energii karty sieciowej. Na przykład karta sieciowa może obsługiwać odciążanie IPv4 ARP, zapytanie sąsiada IPv6 (NS) lub IEEE 802.11 niezawodnej bezpiecznej sieci (RSN) z 4-krokowym i 2-krokowym uzgadnianiem. Aby uzyskać pełną listę odciążeń protokołu obsługiwanych w bieżącym systemie operacyjnym, zobacz stronę referencyjną NDIS_PM_CAPABILITIES.

NumArpOffloadIPv4Addresses
Zawiera liczbę adresów IPv4 przekazywania ARP.

NumNSOffloadIPv6Addresses
Zawiera liczbę żądań odciążania sieci (NS) dla IPv6, które obsługuje karta sieciowa.

MinMagicPacketWakeUp
Określa najniższy stan zasilania urządzenia, z którego karta sieciowa może sygnalizować zdarzenie budzenia po otrzymaniu pakietu magicznego . Pakiet magiczny to pakiet zawierający 16 następujących po sobie kopii adresu Ethernet karty sieciowej odbiorcy.

MinPatternWakeUp
Określa najniższy stan zasilania urządzenia, z którego karta sieciowa może wywołać zdarzenie wybudzenia po odebraniu ramki sieciowej, która zawiera wzorzec określony przez sterownik protokołu.

MinLinkChangeWakeUp
Określa najniższy stan zasilania urządzenia, z którego karta sieciowa może sygnalizować zdarzenie wybudzenia w przypadku zmiany stanu łącza (połączenie z nośnikiem lub rozłączenie).

SupportedWakeUpEvents
Określa zdarzenia wybudzania niezależne od nośnika, które obsługuje karta sieciowa. Te zdarzenia nie są specyficzne dla typu nośnika. Na przykład te zdarzenia wybudzenia obejmują zdarzenia zmiany łącza sieciowego.

MediaSpecificWakeUpEvents
Określa zdarzenia wznawiania specyficzne dla mediów obsługiwane przez kartę sieciową. Na przykład te zdarzenia obejmują następujące elementy:

• Karta sieciowa 802.11 nie kojarzy się z punktem dostępu (AP).

• Adapter sieciowy mobilnych łączy szerokopasmowych (MB) wykrywa zmianę stanu rejestracji w usłudze mobilnych łączy szerokopasmowych.

Jeśli sterownik miniportu obsługuje przekazywanie protokołów do karty sieciowej w stanie niskiego zasilania, musi obsługiwać ten sam stan zasilania dla protokołu przekazywania, który obsługuje dla zdarzenia WOL związanego z dopasowaniem wzorca; oznacza to, że wartość określona w MinPatternWakeUp lub MinMagicPacketWakeUp elementu członkowskiego.

NDIS inicjuje strukturę NDIS_PM_CAPABILITIES z obecnie dostępnymi możliwościami zarządzania energią podstawowej karty sieciowej i przekazuje ją do nadrzędnych sterowników protokołów podczas operacji łączenia. NDIS ustawia element PowerManagementCapabilitiesEx struktury NDIS_BIND_PARAMETERS tak, aby wskazywał na strukturę NDIS_PM_CAPABILITIES.

Sterowniki nadrzędne mogą używać zapytania OID_PM_HARDWARE_CAPABILITIES OID, aby uzyskać informacje o możliwościach zarządzania energią sprzętową karty sieciowej. Usługa NDIS obsługuje to żądanie OID w imieniu sterownika miniportu. Sterowniki miniportu NDIS nie są wymagane do obsługi żądania OID_PM_HARDWARE_CAPABILITIES OID.

Sterowniki nadrzędne mogą używać OID_PM_CURRENT_CAPABILITIES OID, aby zapytać o obecnie dostępne możliwości zarządzania energią karty sieciowej. Usługa NDIS obsługuje to żądanie OID w imieniu sterownika miniportu. Sterowniki miniportu NDIS nie są wymagane do obsługi żądania identyfikatora OID OID_PM_CURRENT_CAPABILITIES.