OID_NIC_SWITCH_ENUM_VFS

2025-03-13

Een te groot stuurprogramma of toepassing in de gebruikersmodus geeft een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_ENUM_VFS om een matrix te verkrijgen. Elk element in de matrix geeft de kenmerken op van een PCI Express (PCIe) Virtual Function (VF) die zijn gekoppeld aan een NIC-switch op de NIC-switch van een netwerkadapter.

Nadat deze OID-queryaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een buffer die het volgende bevat:

Een NDIS_NIC_SWITCH_VF_INFO_ARRAY structuur waarmee het aantal elementen in de matrix wordt gedefinieerd.
Een matrix van NDIS_NIC_SWITCH_VF_INFO structuren. Elk van deze structuren bevat informatie over één VF op een NIC-switch van de netwerkadapter. Een VF is gekoppeld aan een NIC-switch via OID-methodeaanvragen van OID_NIC_SWITCH_ALLOCATE_VF.

Opmerking Als er geen VFS zijn gekoppeld aan een NIC-switch op de netwerkadapter, wordt het NumElements lid van de NDIS_NIC_SWITCH_VF_INFO_ARRAY structuur ingesteld op nul en worden er geen NDIS_NIC_SWITCH_VF_INFO structuren geretourneerd.

Opmerkingen

Bij het overliggen van stuurprogramma's en gebruikersmodustoepassingen worden OID-methodeaanvragen van OID_NIC_SWITCH_ENUM_VFS verzonden om de VFs op te sommen die zijn gekoppeld aan de NIC-switch van een netwerkadapter.

Voordat het stuurprogramma of de toepassing de OID-aanvraag uitgeeft, moet deze een NDIS_NIC_SWITCH_VF_INFO_ARRAY structuur initialiseren die samen met de aanvraag wordt doorgegeven. Het stuurprogramma of de toepassing moet de volgende richtlijnen volgen bij het initialiseren van de NDIS_NIC_SWITCH_VF_INFO_ARRAY structuur:

Als de NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH vlag is ingesteld in de Vlaggen lid, moet het stuurprogramma of de toepassing de SwitchId lid instellen op de NIC-switch-id op de SR-IOV netwerkadapter. Door deze leden op deze manier in te stellen, worden VF-gegevens alleen geretourneerd voor de opgegeven NIC-switch op de SR-IOV netwerkadapter.

Opmerking De overliggende stuurprogramma- en gebruikersmodustoepassing kan de NIC-switch-id's verkrijgen door een OID-queryaanvraag van OID_NIC_SWITCH_ENUM_SWITCHESuit te geven.
Als de Vlaggen lid is ingesteld op nul, moet het stuurprogramma of de toepassing de SwitchId lid instellen op nul. Door deze leden op deze manier in te stellen, worden VF-gegevens geretourneerd voor alle NIC-switch op de SR-IOV netwerkadapter.

Opmerking Vanaf Windows Server 2012 ondersteunt Windows alleen de standaard NIC-switch op de netwerkadapter. Ongeacht de vlaggen die zijn ingesteld in de Vlaggen lid, moet het SwitchId- lid worden ingesteld op NDIS_DEFAULT_SWITCH_ID.

Zie NIC-switchesvoor meer informatie over NIC-switches.

Statuscodes retourneren

NDIS verwerkt de OID-methodeaanvraag van de OID_NIC_SWITCH_ENUM_VFS aanvraag voor minipoortstuurprogramma's. De chauffeurs worden deze OID-aanvraag niet uitgegeven.

Wanneer NDIS de OID_NIC_SWITCH_ENUM_VFS aanvraag verwerkt, wordt een van de volgende statuscodes geretourneerd.

Statuscode	Beschrijving
NDIS_STATUS_SUCCESS	De OID-aanvraag is voltooid.
NDIS_STATUS_NOT_SUPPORTED	Het 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_INFO_ARRAY structuur hebben ongeldige waarden.
NDIS_STATUS_INVALID_LENGTH	De informatiebuffer was te kort. NDIS stelt de DATA in. 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.