Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De OID_PNP_ADD_WAKE_UP_PATTERN OID wordt door een protocolstuurprogramma naar een minipoortstuurprogramma verzonden om een ontwaakpatroon op te geven. Het ontwaakpatroon, samen met het masker, wordt beschreven door een NDIS_PM_PACKET_PATTERN structuur.
Een protocol dat wake-up van patroonovereenkomsten mogelijk maakt voor een minipoortstuurprogramma (zie OID_PNP_ENABLE_WAKE_UP) maakt gebruik van OID_PNP_ADD_WAKE_UP_PATTERN om een ontwaakpatroon op te geven. Het ontwaakpatroon kan worden opgeslagen in hostgeheugen of op de netwerkadapter, afhankelijk van de mogelijkheden van de netwerkadapter.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat het volgende:
Een NDIS_PM_PACKET_PATTERN structuur die informatie biedt over het patroon en het bijbehorende masker.
Een masker dat aangeeft welke bytes van een binnenkomend pakket moeten worden vergeleken met overeenkomende bytes in het patroon. Het masker begint met de eerste byte van het pakket. Het masker volgt onmiddellijk de NDIS_PM_PACKET_PATTERN structuur in de InformationBuffer-. Zie voor meer informatie over hoe dit masker werkt, de referentiespecificatie voor energiebeheer van netwerkapparaten.
Een ontwaakpatroon, dat begint PatternOffset bytes vanaf het begin van de InformationBuffer-. Zie voor meer informatie over ontwaakpatronen de referentiespecificatie voor energiebeheer van netwerkapparaten.
Het aantal ontwaakpatronen dat het minipoortstuurprogramma van een protocol kan accepteren, is mogelijk afhankelijk van de beschikbaarheid van resources, zoals het hostgeheugen dat het minipoortstuurprogramma voor dergelijke patronen heeft toegewezen, of de beschikbare opslag in de netwerkadapter. Als een minipoortstuurprogramma geen ontwaakpatroon kan toevoegen vanwege onvoldoende resources, retourneert het minipoortstuurprogramma NDIS_STATUS_RESOURCES als reactie op OID_PNP_ADD_WAKE_UP_PATTERN.
Als een protocolstuurprogramma probeert een duplicaatpatroon toe te voegen, moet het minipoortstuurprogramma NDIS_STATUS_INVALID_DATA retourneren als reactie op OID_PNP_ADD_WAKE_UP_PATTERN.
Een tussenliggend stuurprogramma waarin de bovenrand deze OID-aanvraag ontvangt, moet de aanvraag altijd doorgeven aan het onderliggende minipoortstuurprogramma door NdisRequest of NdisCoRequestaan te roepen.
Eisen
Versie |
Ondersteund in NDIS 6.0 en NDIS 6.1. Gebruik in plaats daarvan OID_PM_ADD_WOL_PATTERN voor NDIS 6.20 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |