Delen via


OID_NIC_SWITCH_PARAMETERS

Een overliggend stuurprogramma geeft een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_PARAMETERS om de huidige configuratieparameters van een opgegeven NIC-switch op een netwerkadapter te verkrijgen. NDIS verwerkt deze OID-methodeaanvragen voor het minipoortstuurprogramma.

Stuurprogramma's geven een OID-setaanvraag van OID_NIC_SWITCH_PARAMETERS om de configuratieparameters van een opgegeven NIC-switch op een netwerkadapter in te stellen. Deze OID-setaanvragen worden uitgegeven aan het minipoortstuurprogramma van de PCI Express (PCIe) Fysieke functie (PF) van de netwerkadapter. Deze OID-setaanvragen zijn vereist voor PF-minipoortstuurprogramma's die ondersteuning bieden voor de I/O-interface met één hoofdmap (SR-IOV).

De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_NIC_SWITCH_PARAMETERS structuur.

Het overliggende stuurprogramma specificeert de NIC-switch voor de OID-methode of stel de aanvraag in door de SwitchId lid van de NDIS_NIC_SWITCH_PARAMETERS structuur in te stellen op de switch-id. Het overliggende stuurprogramma verkrijgt de switch-id op een van de volgende manieren:

Opmerking Vanaf Windows Server 2012 ondersteunt Windows alleen de standaard NIC-switch op de netwerkadapter. De SwitchId lid van de NDIS_NIC_SWITCH_PARAMETERS structuur moet worden ingesteld op NDIS_DEFAULT_SWITCH_ID.

Opmerkingen

De problemen met te veel stuurprogramma's OID_NIC_SWITCH_PARAMETERS aanvragen op de volgende manier:

  • Het overliggende stuurprogramma geeft een OID-methodeaanvraag van OID_NIC_SWITCH_PARAMETERS om de huidige parameters van een opgegeven NIC-switch te verkrijgen. Zie Query's uitvoeren op de parameters van een NIC-switchvoor meer informatie.

    Opmerking NDIS verwerkt OID-methodeaanvragen van OID_NIC_SWITCH_PARAMETERS voor het PF-minipoortstuurprogramma.

  • Het overliggende stuurprogramma geeft een OID-setaanvraag van OID_NIC_SWITCH_PARAMETERS om de huidige parameters van een opgegeven NIC-switch te wijzigen. Zie Parameters van een NIC-switch instellenvoor meer informatie.

    Opmerking Het PF-minipoortstuurprogramma verwerkt OID-setaanvragen van OID_NIC_SWITCH_PARAMETERS.

Statuscodes retourneren

NDIS of het PF-minipoortstuurprogramma retourneert de volgende statuscodes voor set- of methode-OID-aanvragen van OID_NIC_SWITCH_PARAMETERS.

Statuscode Beschrijving

NDIS_STATUS_SUCCESS

De aanvraag is voltooid. De InformationBuffer- verwijst naar een NDIS_NIC_SWITCH_CAPABILITIES structuur.

NDIS_STATUS_NOT_SUPPORTED

Het PF-minipoortstuurprogramma biedt geen ondersteuning voor de I/O-interface met één hoofdmap (SR-IOV) of is niet ingeschakeld voor het gebruik van de interface.

NDIS_STATUS_INVALID_PARAMETER

Een of meer leden van de NDIS_NIC_SWITCH_PARAMETERS structuur hebben ongeldige waarden.

NDIS_STATUS_INVALID_LENGTH

De informatiebuffer was te kort. NDIS of het PF-minipoortstuurprogramma stelt de DATA in. METHOD_INFORMATION. BytesNeeded lid (voor OID-methodeaanvragen) of DATA. SET_INFORMATION. BytesNeeded lid (voor OID-setaanvragen) in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.

NDIS_STATUS_REINIT_REQUIRED

Het PF-minipoortstuurprogramma vereist een herinitialisatie van de netwerkadapter om de wijzigingen toe te passen op de NIC-switch.

NDIS_STATUS_FAILURE

De aanvraag is om andere redenen mislukt.

Eisen

Versie

Ondersteund in NDIS 6.30 en hoger.

Rubriek

Ntddndis.h (inclusief Ndis.h)

Zie ook


FilterAttach-

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_NIC_SWITCH_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_ENUM_SWITCHES

ProtocolBindAdapterEx-