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
query's uitvoeren op de Hyper-V Uitbreidbare switchconfiguratie