Delen via


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)

Zie ook


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF