Obsługa zapytań i zestawów OID_PNP_Xxx

Wirtualny miniport sterownika pośredniego musi wyeksportować funkcję MiniportOidRequest. NDIS wywołuje funkcję MiniportOidRequest sterownika pośredniego, gdy sterownik nadmiernie powiązany z wirtualnym miniportem sterownika pośredniego wywołuje NdisOidRequest do wykonywania zapytań lub ustawiania obiektów informacji (OID_Xxx). Usługa NDIS może również wywoływać MiniportOidRequest we własnym imieniu. Aby uzyskać więcej informacji na temat obsługi sterowników miniportu w zakresie ustawień i zapytań dotyczących obiektów informacji, zobacz Uzyskiwanie i ustawianie informacji o sterownikach miniportu i obsługa NDIS dla usługi WMI.

Sterownik pośredni powinien przechowywać informacje o możliwościach podstawowych adapterów miniportowych, które otrzymuje w funkcji ProtocolBindAdapterEx. Jeśli karta miniportu nie obsługuje zarządzania energią, usługa NDIS ustawia element PowerManagementCapabilities elementu członkowskiego NDIS_BIND_PARAMETERS na null.

Sterownik pośredni może wykonywać zapytania lub ustawiać OID_Xxx utrzymywany przez podstawowy sterownik miniportu. Robi to z NdisOidRequest(jeśli sterownik pośredni ma dolną krawędź bez połączenia) lub NdisCoOidRequest(jeśli sterownik pośredni ma dolną krawędź zorientowaną na połączenie).

Sterownik pośredni powinien obsługiwać zapytania i zestawy w następujący sposób:

• OID_PNP_CAPABILITIES

  W odpowiedzi na to zapytanie OID, sterowniki pośrednie muszą zgłaszać możliwości Plug and Play podstawowych fizycznych miniportowych adapterów. Pamiętaj, że adaptery miniportowe dla urządzeń fizycznych nie otrzymują tego zapytania OID.

  Sterownik pośredni odbiera możliwości PnP podstawowych adapterów miniportowych w kontekście parametrów powiązania. Należy przekazać je do górnych warstw sterowników, odpowiednio do zamierzonego użycia sterownika pośredniego. Sterowniki pośrednie i sterowniki miniportu raportują możliwości PnP w atrybutach adaptera miniportu. Sterownik pośredni nie wysyła żądań OID_PNP_CAPABILITIES do bazowego sterownika miniportu. Jeśli podstawowa karta miniportu obsługuje zarządzanie energią, w strukturze NDIS_PM_WAKE_UP_CAPABILITIES w atrybutach wirtualnego miniportu, sterownik pośredni musi określić stan zasilania urządzenia NdisDeviceStateUnspecified dla każdej możliwości wznawiania:

  • MinMagicPacketWakeUp
  • MinPatternWakeUp
  • MinimalnaZmianaŁączaPobudka

  Takie ustawienie wskazuje, że sterownik pośredni jest świadomy zarządzania energią, ale nie może obudzić systemu.

• OID_PNP_QUERY_POWER i OID_PNP_SET_POWER

  Sterownik pośredni musi zawsze zwracać NDIS_STATUS_SUCCESS na zapytanie OID_PNP_QUERY_POWER lub na ustawienie OID_PNP_SET_POWER. Sterownik pośredni nigdy nie może propagować jednego z tych żądań OID do bazowego sterownika miniportu.

• Aktywacja identyfikatorów OID

  Jeśli podstawowa karta sieciowa obsługuje zarządzanie energią, sterownik pośredni musi przekazać bazowemu sterownikowi miniportu (wywołując NdisOidRequest lub NdisCoOidRequest) następujące OID_PNP_Xxx odnoszące się do zdarzeń budzenia:

  OID_PNP_ENABLE_WAKE_UP

  OID_PNP_ADD_WAKE_UP_PATTERN

  OID_PNP_USUŃ_WZORZEC_WYBUDZENIA

  OID_PNP_WAKE_UP_PATTERN_LIST

  OID_PNP_WAKE_UP_ERROR

  OID_PNP_WAKE_UP_OK

Sterownik pośredni musi również propagować odpowiedź sterownika miniportu na te OID-y do nadrzędnych sterowników protokołów.

Jeśli podstawowa karta miniportu nie obsługuje zarządzania energią, sterownik miniportu ustawia członka PowerManagementCapabilities struktury NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES na NULL, a NDIS ustawia członka PowerManagementCapabilities struktury NDIS_BIND_PARAMETERS na NULL.

Jeśli podstawowy adapter miniportu nie obsługuje zarządzania energią, sterownik pośredni powinien zwrócić NDIS_STATUS_NOT_SUPPORTED w odpowiedzi na zapytanie lub ustawienie tych OID-ów.