Rapportagemogelijkheden voor energiebeheer

Miniportstuurprogramma's die NDIS 6.20 en latere versies van NDIS ondersteunen, rapporteren hun hardwarebeheermogelijkheden tijdens de initialisatie. NDIS rapporteert de huidige mogelijkheden aan bovenliggende NDIS-protocolstuurprogramma's tijdens de bindingsbewerking. NDIS kan echter bepaalde mogelijkheden van het protocolstuurprogramma verbergen. NDIS kan bijvoorbeeld verschillende mogelijkheden rapporteren wanneer een gebruiker bepaalde of alle mogelijkheden voor energiebeheer uitschakelt.

Houd er rekening mee dat de huidige mogelijkheden voor energiebeheer die NDIS rapporteert aan een protocolstuurprogramma niet noodzakelijkerwijs hetzelfde zijn als de hardwaremogelijkheden die het minipoortstuurprogramma heeft gerapporteerd aan NDIS.

Als een NDIS 6.1- of lager minipoortstuurprogramma is gebonden aan een NDIS 6.20-protocolstuurprogramma, vertaalt NDIS de energiebeheermogelijkheden naar een indeling die wordt ondersteund door het NDIS 6.20-protocolstuurprogramma. NDIS vertaalt ook energiebeheermogelijkheden die een NDIS 6.20-minipoortstuurprogramma rapporteert in een indeling die wordt ondersteund door de NDIS 6.1 en eerdere stuurprogramma's.

De hardwaremogelijkheden die door een minipoortstuurprogramma worden gerapporteerd, kunnen in INF-bestandsinstellingen worden ingeschakeld of uitgeschakeld. Voor meer informatie over instellingen van INF-bestanden voor energiebeheer, zie Gestandaardiseerde INF-trefwoorden voor energiebeheer.

Tijdens de initialisatie van miniport initialiseert een minipoortstuurprogramma een NDIS_PM_CAPABILITIES structuur met de energiebeheermogelijkheden van de onderliggende hardware. Het minipoortstuurprogramma stelt het PowerManagementCapabilitiesEx-lid van de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-structuur in om te verwijzen naar de NDIS_PM_CAPABILITIES structuur.

De NDIS_PM_CAPABILITIES structuur bevat de volgende informatie:

vlaggen
Voor NDIS 6.20 is dit lid gereserveerd voor NDIS.

Vanaf NDIS 6.30 worden de volgende vlaggen gedefinieerd:

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Als deze vlag is ingesteld, kan de netwerkadapter het ontvangen pakket opslaan dat de adapter ertoe bracht een wake-upgebeurtenis te genereren.

Zie NDIS Wake Reason Status Indications voor meer informatie over deze energiebeheerfunctie.

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Wanneer deze vlag is ingesteld, ondersteunt het minipoortstuurprogramma de NDIS-selectieve onderbreking voor netwerkadapters.

Zie NDIS Selective Suspend voor meer informatie over deze energiebeheerfunctie.

SupportedWoLPacketPatterns
Bevat vlaggen die de wake-on-LAN-pakketpatronen (WOL) opgeven die door een netwerkadapter worden ondersteund. De netwerkadapter kan bijvoorbeeld een wake-upgebeurtenis genereren wanneer deze een bitmap, een WOL-magisch pakket of een EAP over LAN (EAPOL) aanvraag-identificatie ontvangt. Zie de NDIS_PM_CAPABILITIES referentiepagina voor een volledige lijst van de patronen die worden ondersteund in het huidige besturingssysteem.

NumTotalWoLPatterns
Een ULONG-waarde die het totale aantal WOL-patronen bevat dat een netwerkadapter ondersteunt. Dit is de som van 'aantal ondersteunde WOL-protocolpatronen' en 'aantal ondersteunde WOL-bitmappatronen'.

Als uw stuurprogramma bijvoorbeeld ondersteuning biedt voor 8 flexibele bitmappatronen, IPv4 TCP SYN (via vooraf ingestelde filter) en magic-pakket, zou u 9 rapporteren in NumTotalWoLPatterns. (8 bitmaps + 1 IPv4 TCP SYN = 9)

Notitie Het totale aantal WOL-patronen bevat niet het magic packet wake-up patroon.

Zie NDIS_PM_WOL_PATTERN voor meer informatie over WOL-protocolpatronen.

MaxWoLPatternSize
Bevat het maximum aantal bytes dat kan worden vergeleken met een patroon.

MaxWoLPatternOffset
Bevat het aantal bytes in een pakket dat kan worden onderzocht, die begint vanaf het begin van de MAC-header.

MaxWoLPacketSaveBuffer
Bevat het aantal bytes van een WOL-protocolpatroon dat een minipoortstuurprogramma kan opslaan in een buffer en de stuurprogrammastack kan aangeven.

SupportedProtocolOffloads
Bevat vlaggen die de offloadfuncties van het energiebeheerprotocol opgeven die door een netwerkadapter worden ondersteund. Miniportstuurprogramma's gebruiken deze vlaggen om de laag vermogen protocol offload-mogelijkheden van een netwerkadapter te rapporteren. De netwerkadapter kan bijvoorbeeld ondersteuning bieden voor IPv4 ARP-offloading, IPv6 Neighbor Solicitation (NS) of IEEE 802.11 robuust veilig netwerk (RSN) 4-weg en 2-weg handshake. Zie de NDIS_PM_CAPABILITIES referentiepagina voor een volledige lijst met protocol-offloads die worden ondersteund in het huidige besturingssysteem.

NumArpOffloadIPv4Addresses
Bevat het aantal ARP-offload-IPv4-adressen.

NumNSOffloadIPv6Addresses
Bevat het aantal netwerkverzoeken (NS) offload IPv6-aanvragen die de netwerkadapter ondersteunt.

MinMagicPacketWakeUp
Specificeert de laagste energiestatus van het apparaat waaruit een netwerkadapter een wekgebeurtenis kan signaleren bij ontvangst van een magic-pakket. (Een magic-pakket is een pakket dat 16 aaneengesloten kopieën van het Ethernet-adres van de ontvangende netwerkadapter bevat.)

MinPatternWakeUp
Hiermee geeft u de laagste energiestatus van het apparaat op waaruit een netwerkadapter een ontwaakgebeurtenis kan signaleren bij ontvangst van een netwerkframe dat een patroon bevat dat is opgegeven door het protocolstuurprogramma.

MinLinkChangeWakeUp
Hiermee geeft u de laagste energiestatus van het apparaat op waaruit een netwerkadapter een ontwaakgebeurtenis kan signaleren wanneer er een koppelingswijziging is (mediaverbinding of verbinding verbreken).

SupportedWakeUpEvents
Hiermee geeft u de media-onafhankelijke ontwaakgebeurtenissen op die door een netwerkadapter worden ondersteund. Deze gebeurtenissen zijn niet specifiek voor het mediatype. Deze wake-upgebeurtenissen omvatten bijvoorbeeld koppelingsveranderingen.

MediaSpecificWakeUpEvents
Hiermee geeft u de mediaspecifieke wake-upgebeurtenissen op die een netwerkadapter ondersteunt. Deze gebeurtenissen zijn bijvoorbeeld:

• De 802.11-netwerkadapter ontkoppelt het toegangspunt (AP).

• De mobiele breedbandnetwerkadapter (MB) detecteert een wijziging in de registratiestatus van de MB-service.

Als een minipoortstuurprogramma protocolen voor offloading ondersteunt naar een netwerkadapter in een lage energiestand, moet het dezelfde lage energiestand ondersteunen voor de protocol-offload die het ondersteunt voor een patroonovereenkomst bij een WOL-gebeurtenis; dat wil zeggen, de waarde die is opgegeven in het lid MinPatternWakeUp of MinMagicPacketWakeUp.

NDIS initialiseert een NDIS_PM_CAPABILITIES structuur met de momenteel beschikbare mogelijkheden voor energiebeheer van de onderliggende netwerkadapter en geeft het door aan bovenliggende protocolstuurprogramma's tijdens de binding operatie. NDIS stelt het PowerManagementCapabilitiesEx-lid van de NDIS_BIND_PARAMETERS-structuur in zodat deze verwijst naar de NDIS_PM_CAPABILITIES structuur.

Overliggende stuurprogramma's kunnen de OID_PM_HARDWARE_CAPABILITIES OID-query gebruiken om de mogelijkheden voor hardwarebeheer van de netwerkadapter te verkrijgen. NDIS verwerkt deze OID-aanvraag namens het minipoortstuurprogramma. NDIS-minipoortstuurprogramma's zijn niet vereist om de OID_PM_HARDWARE_CAPABILITIES OID-aanvraag te ondersteunen.

Overliggende stuurprogramma's kunnen de OID_PM_CURRENT_CAPABILITIES OID gebruiken om een query uit te voeren op de momenteel beschikbare mogelijkheden voor energiebeheer van een netwerkadapter. NDIS verwerkt deze OID-aanvraag namens het minipoortstuurprogramma. NDIS-minipoortstuurprogramma's zijn niet vereist om de OID_PM_CURRENT_CAPABILITIES OID-aanvraag te ondersteunen.