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:
Uit een eerdere OID-methodeaanvraag van OID_NIC_SWITCH_ENUM_SWITCHES.
Vanuit de NicSwitchArray lid van de NDIS_BIND_PARAMETERS structuur. NDIS geeft een aanwijzer door aan deze structuur in de parameter BindParameters van de functie ProtocolBindAdapterEx.
Vanuit de NicSwitchArray lid van de NDIS_FILTER_ATTACH_PARAMETERS-structuur. NDIS geeft een aanwijzer door aan deze structuur in de parameter AttachParameters van de functie FilterAttach.
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) |