OID_NDK_SET_STATE

Als setaanvraag gebruiken NDIS en stuurprogramma's die te veel liggen de OID_NDK_SET_STATE OID om de status van de NDK-functionaliteit van de minipoortadapter in te stellen.

NDIS 6.30 en hoger minipoortstuurprogramma's die NDK-services bieden, moeten deze OID ondersteunen. Anders is deze OID optioneel.

Opmerkingen

NDIS geeft deze OID uit met de InformationBuffer lid van de NDIS_OID_REQUEST-structuur die verwijst naar een booleaanse en InformationBufferLength lid gelijk aan grootteof(booleaanse).

• Als de booleaanse-waarde WAAR is en de *NetworkDirect trefwoordwaarde niet nul is, moet de NDK-functionaliteit van de minipoortadapter zijn ingeschakeld.

  Het minipoortstuurprogramma kan de *NetworkDirect trefwoordwaarde als volgt lezen:

  1. Roep NdisOpenConfigurationEx aan met de NDIS-ingang die de functie NdisMRegisterMiniportDriver geretourneerd toen het minipoortstuurprogramma werd geïnitialiseerd. Zie het register lezen in een NDIS 6.0 Miniport-stuurprogrammavoor meer informatie over het aanroepen van NdisOpenConfigurationEx.

  2. Roep NdisReadConfiguration-aan, waarbij het volgende wordt doorgegeven:

     • "*NetworkDirect" voor de parameter Trefwoord

     • NdisParameterInteger- voor de parameter ParameterType

• Als de booleaanse waarde is ONWAAR, moet de NDK-functionaliteit van de minipoortadapter worden uitgeschakeld.

Als u de NDK-functionaliteit wilt in- of uitschakelen, moet de minipoortstuurprogramma MiniportOidRequest callback-functie de stappen volgen in NDK-functionaliteit in- en uitschakelen.

Opmerking Een minipoortstuurprogramma dat geschikt is voor NDK, mag nooit NdisMNetPnPEvent- aanroepen vanuit de context van de MiniportOidRequest-functie, omdat dit een impasse kan veroorzaken. In plaats daarvan moet het NdisMNetPnPEvent aanroepen vanuit een andere context of een werkitem in de wachtrij plaatsen.

De miniportOidRequest-functie van een minipoortstuurprogramma die geschikt is voor NDK, moet STATUS_SUCCESS retourneren voor een OID_NDK_SET_STATE OID-aanvraag, tenzij er een fout optreedt. De bestuurder mag NDIS_STATUS_PENDINGniet retourneren.

Eisen

Zie ook

NDIS_OID_REQUEST

NdisMNetPnPEvent-

NdisQueueIoWorkItem-

NdisReadConfiguration-

NDK_ADAPTER