OID_NIC_SWITCH_DELETE_SWITCH

Artikel
03/13/2025

NDIS geeft een OID-setaanvraag (Object Identifier) van OID_NIC_SWITCH_DELETE_SWITCH uit om een NIC-switch van een netwerkadapter te verwijderen.

NDIS geeft deze OID-setaanvraag uit aan het minipoortstuurprogramma van de PCI Express (PCIe) fysieke functie (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).

Opmerking Stuurprogramma's die te veel liggen, zoals protocol- of filterstuurprogramma's, kunnen deze OID-methodeaanvraag niet uitgeven aan het PF-minipoortstuurprogramma.

De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS structuur.

Opmerkingen

Een OID-setaanvraag van OID_NIC_SWITCH_DELETE_SWITCH verwijdert een NIC-switch die eerder is gemaakt via een OID-methodeaanvraag van OID_NIC_SWITCH_CREATE_SWITCH.

Wanneer de OID-methodeaanvraag van OID_NIC_SWITCH_DELETE_SWITCH wordt ontvangen, moet het PF-minipoortstuurprogramma het volgende doen:

Als het PF-minipoortstuurprogramma ondersteuning biedt voor het statisch maken en configureren van NIC-switches, moeten de softwarebronnen die zijn gekoppeld aan de opgegeven NIC-switch worden vrijgemaakt. Het stuurprogramma kan echter alleen de hardwarebronnen voor de NIC-switch vrij maken wanneer MiniportHaltEx- wordt aangeroepen.

Zie Statische creatie van een NIC-switchvoor meer informatie over het maken van een statische NIC-switch.
Als het PF-minipoortstuurprogramma ondersteuning biedt voor het dynamisch maken en configureren van NIC-switches, moeten de hardware- en softwarebronnen die zijn gekoppeld aan de opgegeven NIC-switch, worden vrijgemaakt.

Zie Dynamische creatie van een NIC-switchvoor meer informatie over het maken van een dynamische NIC-switch.
Als het PF-minipoortstuurprogramma ondersteuning biedt voor het dynamisch maken en alle NIC-switches zijn verwijderd, moet het stuurprogramma virtualisatie op de adapter uitschakelen door NdisMEnableVirtualization-aan te roepen. Als u virtualisatie wilt uitschakelen, moet de netwerkadapter de parameter EnableVirtualization instellen op FALSE en de parameter NumVFs op nul.

NdisMEnableVirtualization wist de NumVFs lid en de VF Enable bit in de SR-IOV Extended Capability structure in de PCI-configuratieruimte van de PF van de netwerkadapter.

Opmerking Als het PF-minipoortstuurprogramma ondersteuning biedt voor statisch maken en configureren van NIC-switches, mag deze alleen NdisMEnableVirtualization aanroepen wanneer MiniportHaltEx- wordt aangeroepen.

Zie Een NIC-switch verwijderenvoor meer informatie.

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_DELETE_SWITCH_PARAMETERS structuur hebben ongeldige waarden.
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.