Delen via


OID_SWITCH_NIC_ARRAY

Een Hyper-V uitbreidbare switchextensie geeft een OID-queryaanvraag (Object Identifier) van OID_SWITCH_NIC_ARRAY uit om een matrix te verkrijgen. Elk element in de matrix geeft de configuratieparameters op van een virtuele netwerkadapter die is gekoppeld aan een uitbreidbare switchpoort.

Als de OID-queryaanvraag is voltooid, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een buffer. Deze buffer bevat de volgende gegevens:

  • Een NDIS_SWITCH_NIC_ARRAY structuur waarmee het aantal elementen in de matrix wordt gedefinieerd. Deze structuur geeft ook de verschuiving aan het eerste element in de matrix.

  • Een matrix van NDIS_SWITCH_NIC_PARAMETERS structuren. Elk van deze structuren bevat informatie over een netwerkadapter die is verbonden met een uitbreidbare switchpoort.

    Opmerking Als er geen netwerkadapters zijn verbonden met uitbreidbare switchpoorten, stelt de onderliggende minipoortrand van de uitbreidbare switch het NumElements- lid van de NDIS_SWITCH_NIC_ARRAY structuur in op nul. In dit geval worden er geen NDIS_SWITCH_NIC_PARAMETERS structuren geretourneerd.

Opmerkingen

De OID_SWITCH_NIC_ARRAY OID mag alleen worden uitgegeven wanneer de Hyper-V uitbreidbare switch is geactiveerd. Zie query's uitvoeren op de Hyper-V Uitbreidbare switchconfiguratie voor meer informatie.

Wanneer de extensie de geretourneerde NDIS_SWITCH_NIC_PARAMETERS structuur verwerkt, mag niet worden aangenomen dat de verschillende tekenreeksleden van de NDIS_SWITCH_PORT_PARAMETERS structuur, zoals NicFriendlyName, null-beƫindigd zijn. De gegevenstypen voor deze tekenreeksleden worden door de IF_COUNTED_STRING structuur gedefinieerd. Het stuurprogramma moet de tekenreekslengte bepalen op basis van de waarde van de Lengte lid van deze structuur.

Opmerking Als de tekenreeks null-beƫindigd is, mag het Lengte lid het afsluit-null-teken niet bevatten.

Statuscodes retourneren

De onderliggende minipoortrand van de uitbreidbare switch voltooit de OID-queryaanvraag van OID_SWITCH_NIC_ARRAY en retourneert een van de volgende statuscodes.

Statuscode Beschrijving

NDIS_STATUS_SUCCESS

De OID-aanvraag is voltooid.

NDIS_STATUS_INVALID_LENGTH

De lengte van de informatiebuffer is te klein om de NDIS_SWITCH_NIC_ARRAY en de matrix van NDIS_SWITCH_NIC_PARAMETERS elementen te retourneren. De onderliggende minipoortrand van de uitbreidbare switch stelt de DATA in. QUERY_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_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

query's uitvoeren op de Hyper-V Uitbreidbare switchconfiguratie