Overzicht van NDIS Wake Reason Statusaanduidingen
Vanaf NDIS 6.30 geven minipoortstuurprogramma's een NDIS wake reason-statusindicatie (NDIS_STATUS_PM_WAKE_REASON) af om NDIS en hogerliggende stuurprogramma's te informeren over de reden voor een systeemwaakgebeurtenis. Als de netwerkadapter een wake-upgebeurtenis genereert, geeft het minipoortstuurprogramma onmiddellijk een NDIS-statusindicatie van NDIS_STATUS_PM_WAKE_REASON af wanneer de netwerkadapter naar volledig vermogen wordt hervat.
Opmerking Ondersteuning voor statusaanduidingen voor NDIS wake-reden is optioneel voor minipoortstuurprogramma's van Mobile Broadband (MB).
Het minipoortstuurprogramma is geconfigureerd met parameters voor energiebeheer (PM) via een object-id (OID) setaanvraag van OID_PM_PARAMETERS. Deze OID-aanvraag specificeert de PM-parameters via een NDIS_PM_PARAMETERS structuur.
De NDIS_PM_PARAMETERS structuur geeft de parameters op voor de volgende typen wake-up-gebeurtenissen.
ontvangen gebeurtenissen voor het ontwaaken van pakketten
De netwerkadapter genereert een wake-upgebeurtenis als er een pakket wordt ontvangen dat overeenkomt met een wake-on-LAN-patroon (WOL). WOL-patronen omvatten het volgende:
Media-onafhankelijke WOL-patronen, zoals magic-pakketten of TCP/IP-gegevenspatronen binnen de inhoud van het pakket. De NDIS_PM_PARAMETERS-structuur kan bijvoorbeeld een WOL-patroon voor een TCP SYN-frame opgeven.
Mediaspecifieke WOL-patronen, zoals een EAPOL-verzoek-identificatiepakket of een bericht voor mobiele breedband (MB) voor de dienst Short Message Service (SMS).
Jokertekens die overeenkomen met een ontvangstfilter dat is opgegeven via een OID-verzoek van OID_GEN_CURRENT_PACKET_FILTER.
Opmerking Voor dit type statusaanduiding van de waakreden moet de netwerkadapter het ontvangen pakket kunnen opslaan. Het stuurprogramma moet het ontvangen pakket retourneren binnen de statusindicatie.
WOL-patronen worden opgegeven via de EnabledWoLPacketPatterns lid van de NDIS_PM_PARAMETERS-structuur.
Media-Specific Wake-upgebeurtenissen
De netwerkadapter genereert een wake-upgebeurtenis vanwege een mediaspecifieke reden, zoals een ontkoppeling van een 802.11-toegangspunt (AP) of de ontvangst van een sms-bericht (Mobile Broadband Service).
Wake-upgebeurtenissen van dit type worden gespecificeerd via het element MediaSpecificWakeUpEvents van de structuur NDIS_PM_PARAMETERS.
Media-Independent Wake-up Gebeurtenissen
De netwerkadapter genereert een weksignaal vanwege een media-onafhankelijke reden, zoals mediaverbinding of verlies van verbinding.
Wake-upgebeurtenissen van dit type worden opgegeven via de WakeUpFlags lid van de NDIS_PM_PARAMETERS structuur.
Het minipoortstuurprogramma moet de volgende richtlijnen volgen voor statusindicaties voor NDIS wake reason:
Als het minipoortstuurprogramma ondersteuning biedt voor de mogelijkheid om wake-pakketindicaties uit te geven, moet deze mogelijkheid worden gemeld wanneer NDIS de MiniportInitializeEx functie aanroept. Zie Reporting Wake Reason Indication Capabilitiesvoor meer informatie.
Opmerking De miniportdriver hoeft geen melding te maken van zijn mogelijkheid tot uitgifte van NDIS wake reason-statusaanduidingen voor gebeurtenissen die niet zijn gerelateerd aan de ontvangst van een WOL-pakket.
Wanneer het minipoortstuurprogramma een wake-pakketindicatie voor een WOL-pakket uitgeeft, moet het pakket worden opgenomen dat de ontwaakgebeurtenis heeft veroorzaakt. Raadpleeg Voor het uitgeven van NDIS Wake Reason Statusindicatiesvoor meer informatie.
Als de netwerkadapter een ontwaaksignaal heeft gegenereerd, moet het minipoortstuurprogramma een NDIS_STATUS_PM_WAKE_REASON-statusindicatie geven. Het stuurprogramma doet dit terwijl het de OID-setaanvraag van OID_PNP_SET_POWER verwerkt voor de overgang naar een volledige energiestatus.
Het minipoortstuurprogramma moet een NDIS_STATUS_PM_WAKE_REASON statusindicatie uitgeven voordat een statusindicatie wordt uitgegeven die gerelateerd is aan de wake-upgebeurtenis. Als de wake-upgebeurtenis bijvoorbeeld is veroorzaakt door een wijziging in de mediaverbindingsstatus, moet het minipoortstuurprogramma een NDIS_STATUS_LINK_STATE statusindicatie geven nadat deze de statusindicatie NDIS_STATUS_PM_WAKE_REASON heeft uitgegeven.
Het minipoortstuurprogramma moet alleen een NDIS_STATUS_PM_WAKE_REASON statusindicatie uitgeven voor stroombeheer-gebeurtenissen die eerder ingeschakeld zijn via een OID-instelverzoek van OID_PM_PARAMETERS.
Het minipoortstuurprogramma moet alleen een NDIS_STATUS_PM_WAKE_REASON-statusindicatie uitgeven voor wake-upevents die zijn gegenereerd door de onderliggende netwerkadapter.