OID_NIC_SWITCH_CREATE_VPORT
Een overliggend stuurprogramma geeft een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_CREATE_VPORT om een niet-standaard virtuele poort (VPort) te maken op de NIC-switch van een netwerkadapter. Deze OID-methodeaanvraag koppelt de gemaakte VPort ook aan de FYSIEKE FUNCTIE (PCIe) van de netwerkadapter of een eerder toegewezen VF (Virtual Function) van de netwerkadapter.
Bij het overliggen van stuurprogramma's wordt deze OID-methodeaanvraag naar het minipoortstuurprogramma voor de PF van de netwerkadapter verzonden. Deze OID-methodeaanvraag is 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 de NDIS_NIC_SWITCH_VPORT_PARAMETERS structuur.
Opmerkingen
Het overliggende stuurprogramma initialiseert de NDIS_NIC_SWITCH_VPORT_PARAMETERS structuur met de configuratiegegevens over de niet-standaard-VPort die moet worden gemaakt. De configuratie-informatie bevat de PCIe-functie waaraan de niet-standaard-VPort is gekoppeld en het aantal wachtrijparen voor de niet-standaard-VPort.
Wanneer het PF-minipoortstuurprogramma de OID-aanvraag heeft uitgegeven, wijst het stuurprogramma de hardware- en softwarebronnen toe die zijn gekoppeld aan de opgegeven niet-standaard-VPort. Nadat alle resources zijn toegewezen, voltooit het PF-minipoortstuurprogramma de OID door NDIS_STATUS_SUCCESS van MiniportOidRequestte retourneren.
Als de OID_NIC_SWITCH_CREATE_VPORT aanvraag is voltooid, moeten het PF-minipoortstuurprogramma en het overliggende stuurprogramma de VPortId--waarde van de niet-standaard-VPort behouden voor opeenvolgende bewerkingen. De VPortId--waarde wordt gebruikt tijdens deze bewerkingen:
NDIS en de bovenliggende stuurprogramma's gebruiken de VPortId waarde om de niet-standaard-VPort te identificeren in opeenvolgende OID-aanvragen die betrekking hebben op deze VPort, zoals OID_NIC_SWITCH_VPORT_PARAMETERS en OID_NIC_SWITCH_DELETE_VPORT.
Tijdens verzendbewerkingen geeft NDIS de VPortId waarde op om de VPort te identificeren waaruit een pakket is verzonden. Deze waarde wordt opgegeven in de out-of-band (OOB) NDIS_NET_BUFFER_LIST_FILTERING_INFO gegevens van de NET_BUFFER_LIST structuur.
Tijdens ontvangstbewerkingen geeft het PF-minipoortstuurprogramma de VPortId waarde op waarnaar een pakket moet worden doorgestuurd. Deze waarde wordt ook opgegeven in de OOB-NDIS_NET_BUFFER_LIST_FILTERING_INFO gegevens van de NET_BUFFER_LIST-structuur.
Zie Een virtuele poort makenvoor meer informatie.
Opmerking De standaard-VPort bestaat altijd en wordt niet gemaakt door een OID-aanvraag van OID_NIC_SWITCH_CREATE_VPORT. De standaard-VPort heeft een id van NDIS_DEFAULT_VPORT_ID. Wanneer het PF-minipoortstuurprogramma een NIC-switch maakt, koppelt het stuurprogramma automatisch de standaard-VPort aan de PF van de netwerkadapter.
Statuscodes retourneren
NDIS of het PF-minipoortstuurprogramma retourneert een van de volgende statuscodes voor de aanvraag van de OID-methode van OID_NIC_SWITCH_CREATE_SWITCH.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
NDIS_STATUS_NOT_SUPPORTED |
Het PF-minipoortstuurprogramma biedt geen ondersteuning voor de SR-IOV interface of is niet ingeschakeld voor het gebruik van de interface. |
NDIS_STATUS_INVALID_PARAMETER |
Een of meer leden van de NDIS_NIC_SWITCH_VPORT_PARAMETERS structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan de grootte (NDIS_NIC_SWITCH_VPORT_PARAMETERS). Het PF-minipoortstuurprogramma moet de DATA instellen. METHOD_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 mislukt. |
Eisen
Versie |
Ondersteund in NDIS 6.30 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |