Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
NDIS geeft een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_CREATE_SWITCH uit om een NIC-switch op een netwerkadapter te maken. Wanneer deze OID-aanvraag wordt verwerkt, wijst het minipoortstuurprogramma de resources toe voor de NIC-switch op de adapter.
NDIS geeft deze OID-methodeaanvraag uit aan het minipoortstuurprogramma van de PCI Express (PCIe) Fysieke functie (PF) van de netwerkadapter. Deze OID-methodeaanvraag is vereist voor PF-minipoortstuurprogramma's die ondersteuning bieden voor de I/O-interface met één hoofdmap (SR-IOV).
Opmerking Stuurprogramma's die te veel liggen, zoals protocol- of filterstuurprogramma's, kunnen geen OID-methodeaanvragen van OID_NIC_SWITCH_CREATE_SWITCH verzenden naar het PF-minipoortstuurprogramma.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_NIC_SWITCH_PARAMETERS structuur.
Opmerkingen
Wanneer het de aanvraag van de OID-methode van OID_NIC_SWITCH_CREATE_SWITCH ontvangt, moet het PF-minipoortstuurprogramma het volgende doen:
Als het PF-minipoortstuurprogramma ondersteuning biedt voor het maken en configureren van statische switch, wordt de NIC-switch gemaakt wanneer NDIS MiniportInitializeExaanroept. Wanneer het stuurprogramma deze OID-aanvraag verwerkt, moet deze de configuratieparameters in de NDIS_NIC_SWITCH_PARAMETERS structuur controleren. De parameters moeten hetzelfde zijn als de parameters die door het stuurprogramma worden gebruikt om de schakeloptie te maken tijdens de aanroep naar MiniportInitializeEx. Als dit niet waar is, moet het stuurprogramma de OID-aanvraag mislukken.
Zie Statische creatie van een NIC-switchvoor meer informatie.
Als het PF-minipoortstuurprogramma ondersteuning biedt voor het maken en configureren van dynamische switches, moet het stuurprogramma de configuratiewaarden van de NDIS_NIC_SWITCH_PARAMETERS structuur valideren en de NIC-switch maken op basis van deze waarden.
Zie Dynamische creatie van een NIC-switchvoor meer informatie.
Het PF-minipoortstuurprogramma moet de benodigde hardware- en softwarebronnen toewijzen voor de standaard-VPort op de NIC-switch.
Opmerking De standaard-VPort wordt altijd gemaakt via een OID-aanvraag van OID_NIC_SWITCH_CREATE_SWITCH en verwijderd via een OID-aanvraag van OID_NIC_SWITCH_DELETE_SWITCH. OID-aanvragen van OID_NIC_SWITCH_CREATE_VPORT en OID_NIC_SWITCH_DELETE_VPORT worden gebruikt voor het maken en verwijderen van niet-standaard-VPorts op de NIC-switch.
Het PF-minipoortstuurprogramma dat ondersteuning biedt voor het maken en configureren van dynamische switches, moet SR-IOV virtualisatie op de switch inschakelen door NdisMEnableVirtualization-aan te roepen. Met deze aanroep configureert u het NumVFs lid en de VF Enable bit in de SR-IOV Extended Capability Structure van de PCI Express-configuratieruimte (PCIe) van de adapter.
Zie de specificatie PCI-SIG I/O-virtualisatie met één hoofdmap en delen 1.1 voor meer informatie over de SR-IOV configuratieruimte.
Opmerking Als het PF-minipoortstuurprogramma ondersteuning biedt voor het maken van statische switch, wordt SR-IOV virtualisatie ingeschakeld nadat de switch is gemaakt wanneer MiniportInitializeEx wordt aangeroepen.
Als het PF-minipoortstuurprogramma de aanvraag van de OID-methode van OID_NIC_SWITCH_CREATE_SWITCH heeft voltooid, kan het volgende gebeuren:
VFs kunnen worden toegewezen op de NIC-switch via OID-methodeaanvragen van OID_NIC_SWITCH_ALLOCATE_VF.
Niet-standaard-VPorts kunnen worden gemaakt op de NIC-switch via OID-methodeaanvragen van OID_NIC_SWITCH_CREATE_VPORT.
Zie De OID_NIC_SWITCH_CREATE_SWITCH Aanvraagverwerken voor meer informatie over het afhandelen van deze OID-aanvraag.
Statuscodes retourneren
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_PARAMETERS structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan de grootte (NDIS_NIC_SWITCH_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) |