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.
Als set gebruiken NDIS-protocolstuurprogramma's de OID_PM_ADD_WOL_PATTERN OID om een wake-on-LAN-patroon voor energiebeheer toe te voegen aan een netwerkadapter. De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_PM_WOL_PATTERN structuur.
Opmerkingen
NDIS 6.20 en hoger gebruiken protocolstuurprogramma's OID_PM_ADD_WOL_PATTERN om een Wake on LAN-patroon (WOL) toe te voegen aan een netwerkadapter. De OID-aanvraag bevat het criterium dat de netwerkadapter moet worden vergeleken met binnenkomende pakketten wanneer deze een lage energiestatus heeft. De netwerkadapter moet een wake-up-gebeurtenis genereren wanneer er een pakket wordt ontvangen dat overeenkomt met de patrooncriteria.
Een protocolstuurprogramma kan WOL-patronen toevoegen nadat het is verbonden met een onderliggende netwerkadapter en zodra het de benodigde gegevens (zoals het IP-adres van de interface) heeft om het WOL-patroon in te stellen. Het protocolstuurprogramma kan ook een WOL-patroon toevoegen als reactie op een aantal andere meldingen over energiebeheergebeurtenissen, zoals het afwijzen van een eerder toegevoegd WOL-patroon of een offloaded protocol.
Om raceomstandigheden te voorkomen in NDIS en andere protocolstuurprogramma's die zijn gebonden aan dezelfde minipoortadapter, zal NDIS een netwerkadapter instellen op een lage energiestatus, geen poging om een nieuw ontwaakpatroon toe te voegen aan die netwerkadapter. Als een NDIS-protocolstuurprogramma bijvoorbeeld probeert een nieuw WOL-patroon toe te voegen in de context van het verwerken van een NetEventSetPower gebeurtenismelding voor die netwerkadapter, mislukt NDIS de aanvraag.
Voordat NDIS deze OID-aanvraag naar de onderliggende NDIS-stuurprogramma's verzendt of de aanvraag naar het overliggende stuurprogramma voltooit, wordt de ULONG PatternId lid van de NDIS_PM_WOL_PATTERN structuur ingesteld op een unieke waarde. Protocolstuurprogramma's en NDIS gebruiken deze patroon-id met de OID_PM_REMOVE_WOL_PATTERN OID-aanvraag om het WOL-patroon van de onderliggende netwerkadapter te verwijderen.
Opmerking De patroon-id is een unieke waarde voor elk van de patronen die zijn ingesteld op een netwerkadapter. De patroon-id is echter niet wereldwijd uniek voor alle minipoortadapters.
Als NDIS of een onderliggende netwerkadapter een WOL-patroon verwijdert, wordt er een NDIS_STATUS_PM_WOL_PATTERN_REJECTED statusindicatie gegenereerd. De StatusBuffer lid van de NDIS_STATUS_INDICATION structuur bevat de ULONG WOL-patroon-id van het afgewezen WOL-patroon.
Het minipoortstuurprogramma retourneert een van de volgende statuscodes voor de aanvraag:
NDIS_STATUS_SUCCESS
Het aangevraagde patroon is toegevoegd. De PatternId lid van de NDIS_PM_WOL_PATTERN structuur bevat een patroon-id.
NDIS_STATUS_PENDING
De aanvraag is in behandeling. NDIS geeft de laatste statuscode en resultaten door aan de voltooiingshandler van de OID-aanvraag van de aanroeper nadat de aanvraag is voltooid.
NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
De aanvraag is mislukt omdat de patroonlijst vol is en de netwerkadapter geen ander patroon kan toevoegen.
NDIS_STATUS_RESOURCES
NDIS of onderliggende netwerkadapter kan het nieuwe patroon niet toevoegen vanwege gebrek aan resources.
NDIS_STATUS_INVALID_PARAMETER
Een of meer parameters in de NDIS_PM_WOL_PATTERN-structuur zijn ongeldig.
NDIS_STATUS_BUFFER_TOO_SHORT
De informatiebuffer was te kort. NDIS stelt de DATA in. SET_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.
NDIS_STATUS_NOT_SUPPORTED
De netwerkadapter biedt geen ondersteuning voor het aangevraagde WOL-patroon.
NDIS_STATUS_FAILURE
De aanvraag is om andere redenen dan de voorgaande redenen mislukt.
Eisen
Versie |
Ondersteund in NDIS 6.20 en hoger. Verplicht voor minipoortstuurprogramma's. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |