OID_NIC_SWITCH_FREE_VF

2025-03-13

Een overliggend stuurprogramma geeft een object-id (OID) setaanvraag van OID_NIC_SWITCH_FREE_VF om de resources voor de PCI Express (PCIe) Virtual Function (VF) van een netwerkadapter vrij te maken.

Bij het overliggen van stuurprogramma's wordt deze OID-setaanvraag verzonden naar het minipoortstuurprogramma voor de PCIe Physical Function (PF) van de netwerkadapter. Deze OID-setaanvraag 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_FREE_VF_PARAMETERS structuur.

Het overliggende stuurprogramma specificeert de id van de VF die moet worden vrijgemaakt via de VFId lid van deze structuur. Het stuurprogramma heeft deze id verkregen van een eerdere OID-methodeaanvraag van OID_NIC_SWITCH_ALLOCATE_VF.

Opmerkingen

Een overliggend stuurprogramma geeft een OID-setaanvraag van OID_NIC_SWITCH_FREE_VF om de resources voor een VF vrij te maken. Deze resources zijn eerder toegewezen via een OID-methodeaanvraag van OID_NIC_SWITCH_ALLOCATE_VF.

Zie Resources vrijmaken voor een virtuele functievoor meer informatie over het vrijmaken van VF-resources.

Opmerking Zodra een overliggend stuurprogramma resourcetoewijzing voor een VF aanvraagt, 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

De MiniportOidRequest-functie van het minipoortstuurprogramma retourneert een van de volgende waarden voor deze aanvraag:

Term	Beschrijving
NDIS_STATUS_SUCCESS	Het minipoortstuurprogramma heeft de aanvraag voltooid.
NDIS_STATUS_PENDING	Het minipoortstuurprogramma voltooit de aanvraag asynchroon. Nadat het minipoortstuurprogramma alle verwerking heeft voltooid, moet deze de aanvraag voltooien door de NdisMOidRequestComplete-functie aan te roepen en NDIS_STATUS_SUCCESS door te geven voor de parameter Status.
NDIS_STATUS_NOT_ACCEPTED	Het minipoortstuurprogramma wordt opnieuw ingezet.
NDIS_STATUS_REQUEST_ABORTED	Het minipoortstuurprogramma heeft de aanvraag niet meer verwerkt. NDIS heeft bijvoorbeeld de functie MiniportResetEx genoemd.

NDIS retourneert een van de volgende statuscodes voor deze aanvraag:

Term	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_FILE_NOT_FOUND	Een of meer leden van de NDIS_NIC_SWITCH_FREE_VF_PARAMETERS structuur hebben ongeldige waarden. Het VFId lid kan bijvoorbeeld een VF opgeven die niet is toegewezen of VPorts bevat die niet zijn verwijderd.
NDIS_STATUS_INVALID_LENGTH	De informatiebuffer is te klein. NDIS stelt de DATA in. SET_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.