OID_NIC_SWITCH_ENUM_VPORTS

Een overliggend stuurprogramma of toepassing in de gebruikersmodus geeft een aanvraag van de OID-methode (Object Identifier) van OID_NIC_SWITCH_ENUM_VPORTS om een matrix te verkrijgen. Elk element in de matrix geeft de kenmerken op van een virtuele poort (VPort) die is gemaakt 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_VPORT_INFO_ARRAY structuur waarmee het aantal elementen in de matrix wordt gedefinieerd.

• Een matrix van NDIS_NIC_SWITCH_VPORT_INFO structuren. Elk van deze structuren bevat informatie over een VPort op de NIC-switch van de netwerkadapter.

  Opmerking Als er geen VPorts zijn gemaakt op de netwerkadapter, stelt het stuurprogramma het NumElements- lid van de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-structuur in op nul en worden er geen NDIS_NIC_SWITCH_VPORT_INFO structuren geretourneerd.

Opmerkingen

Het overliggen van stuurprogramma's en toepassingen in de gebruikersmodus geven OID-queryaanvragen van OID_NIC_SWITCH_ENUM_VPORTS om de VPorts op te sommen die zijn toegewezen op de NIC-switch van een netwerkadapter.

Voordat het stuurprogramma of de toepassing de OID-aanvraag uitgeeft, moet deze een NDIS_NIC_SWITCH_VPORT_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_VPORT_INFO_ARRAY structuur:

• Als de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH vlag is ingesteld in de Vlaggen lid, wordt informatie geretourneerd voor alle VPorts die zijn gemaakt op een opgegeven NIC-switch. De NIC-switch wordt opgegeven door de SwitchId lid van die structuur.

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

• Als de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION vlag is ingesteld in de Vlaggen lid, wordt informatie geretourneerd voor alle VPorts die zijn gekoppeld aan een opgegeven PCI Express (PCIe) fysieke functie (PF) of virtuele functie (VF) op de netwerkadapter. De PF of VF wordt opgegeven door de AttachedFunctionId lid van die structuur.

  Als het lid AttachedFunctionId is ingesteld op NDIS_PF_FUNCTION_ID, wordt informatie geretourneerd voor alle VPorts, inclusief de standaard-VPort, die zijn gekoppeld aan de PF van de netwerkadapter. Als het AttachedFunctionId lid is ingesteld op een geldige VF-id, wordt informatie geretourneerd voor alle VPorts naar de opgegeven VF.

  Opmerking Vanaf Windows Server 2012 kan slechts één niet-standaard-VPort worden gekoppeld aan een VF. Meerdere VPorts (inclusief de standaard-VPort) kunnen echter worden gekoppeld aan de PF.

• Als de vlaggen lid is ingesteld op nul, wordt informatie geretourneerd voor alle VPorts die zijn gekoppeld aan de PF of VF op de netwerkadapter. In dit geval worden de waarden van de SwitchId en AttachedFunctionId genegeerd.

Zie Virtuele poorten op een netwerkadapteropsommen voor meer informatie.

Statuscodes retourneren

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

Wanneer NDIS de OID_NIC_SWITCH_ENUM_VPORTS aanvraag verwerkt, wordt een van de volgende statuscodes geretourneerd:

Eisen

Zie ook

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS