OID_NIC_SWITCH_ALLOCATE_VF
Een te groot stuurprogramma geeft een aanvraag van de OID-methode (Object Identifier) van OID_NIC_SWITCH_ALLOCATE_VF toe om resources toe te wijzen voor een PCI Express (PCIe) Virtual Function (VF). De VF wordt weergegeven op een netwerkadapter die ondersteuning biedt voor de I/O-interface met één hoofdmap (SR-IOV).
Bij het overliggen van stuurprogramma's wordt deze OID-methodeaanvraag naar het minipoortstuurprogramma voor de PCIe Physical Function (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 een NDIS_NIC_SWITCH_VF_PARAMETERS structuur.
Opmerkingen
Het PF-minipoortstuurprogramma wijst softwarebronnen toe voor een VF wanneer het stuurprogramma een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_ALLOCATE_VF afhandelt. Hoewel de hardwarebronnen zijn toegewezen voor een VF, wordt het beschouwd als niet-bewerkingen totdat het PF-minipoortstuurprogramma de OID_NIC_SWITCH_ALLOCATE_VF heeft voltooid.
Zie Resources toewijzen voor een virtuele functievoor meer informatie over het toewijzen van VF-resources.
Opmerking Nadat een overliggend stuurprogramma resourcetoewijzing voor een VF heeft aangevraagd, is dat stuurprogramma het enige onderdeel dat het vrijmaken van de resources voor dezelfde VF kan aanvragen. Het overliggende stuurprogramma moet een OID-setaanvraag van OID_NIC_SWITCH_FREE_VF uitgeven om de VF-resources vrij te maken. Voordat het overliggende stuurprogramma kan worden gestopt, moet het de resources vrijmaken voor elke VF die is toegewezen door de OID_NIC_SWITCH_ALLOCATE_VF aanvraag van het stuurprogramma.
Statuscodes retourneren
Het PF-minipoortstuurprogramma retourneert een van de volgende statuscodes voor de aanvraag van de OID-methode van OID_NIC_SWITCH_ALLOCATE_VF.
Statuscode | Beschrijving |
---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
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_VF_PARAMETERS structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan de grootte (NDIS_NIC_SWITCH_VF_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) |