OID_PM_WOL_PATTERN_LIST

Als query kunnen overliggende stuurprogramma's de OID_PM_WOL_PATTERN_LIST OID gebruiken om de wake on LAN-patronen op te sommen die zijn ingesteld op een onderliggende netwerkadapter. Nadat de query is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een lijst met NDIS_PM_WOL_PATTERN structuren die de momenteel toegevoegde WOL-patronen beschrijven.

Opmerkingen

NDIS verwerkt de query voor minipoortstuurprogramma's. NDIS-stuurprogramma's kunnen de OID_PM_WOL_PATTERN_LIST OID gebruiken om een lijst met wake on LAN-patronen op te halen die zijn ingesteld op een onderliggende netwerkadapter.

Voor elke NDIS_PM_WOL_PATTERN structuur in de lijst stelt NDIS de NextWoLPatternOffset lid in op de verschuiving van het begin van de OID-informatiebuffer (dat wil gezegd, het begin van de buffer waarnaar het InformationBuffer lid van de NDIS_OID_REQUEST structuur verwijst) naar het begin van de volgende NDIS_PM_WOL_PATTERN structuur in de lijst. De verschuiving in de NextWoLPatternOffset lid van de laatste structuur in de lijst is nul.

Voor offsets in een andere NDIS_PM_WOL_PATTERN structuur dan NextWoLPatternOffset (bijvoorbeeld NameBufferOffset), biedt NDIS offsets die ten opzichte van het begin van elke NDIS_PM_WOL_PATTERN-structuur liggen.

Als er geen WOL-patronen zijn ingesteld op de netwerkadapter, stelt NDIS de DATA in. QUERY_INFORMATION. BytesWritten lid van de NDIS_OID_REQUEST structuur naar nul en retourneert NDIS_STATUS_SUCCESS voor de aanvraag. De gegevens in de DATA. QUERY_INFORMATION. InformationBuffer lid wordt niet gewijzigd door NDIS.

NDIS retourneert een van de volgende statuscodes voor de aanvraag:

NDIS_STATUS_SUCCESS
De aanvraag is voltooid. De InformationBuffer- bevat een aanwijzer naar een lijst met WOL-patronen, indien van toepassing.

NDIS_STATUS_PENDING
De aanvraag is in behandeling. De laatste statuscode en resultaten worden doorgegeven aan de voltooiingshandler van de OID-aanvraag van de aanroeper.

NDIS_STATUS_BUFFER_TOO_SHORT
De informatiebuffer was te kort. NDIS stelt de DATA in. QUERY_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.

NDIS_STATUS_FAILURE
De aanvraag is om andere redenen dan de voorgaande redenen mislukt.

Eisen

Zie ook

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST