OID_SWITCH_NIC_ARRAY

Ett Hyper-V utökningsbart växeltillägg utfärdar en OID-frågebegäran (object identifier) för OID_SWITCH_NIC_ARRAY för att hämta en matris. Varje element i matrisen anger konfigurationsparametrarna för ett virtuellt nätverkskort som är associerat med en utökningsbar växelport.

Om OID-frågebegäran har slutförts innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en buffert. Den här bufferten innehåller följande data:

• En NDIS_SWITCH_NIC_ARRAY struktur som definierar antalet element i matrisen. Den här strukturen anger också förskjutningen till det första elementet i matrisen.

• En matris med NDIS_SWITCH_NIC_PARAMETERS strukturer. Var och en av dessa strukturer innehåller information om ett nätverkskort som är anslutet till en utökningsbar växelport.

  Observera Om inga nätverkskort är anslutna till utökningsbara växelportar anger den utökningsbara växelns underliggande miniportgräns NumElements medlem i NDIS_SWITCH_NIC_ARRAY struktur till noll. I det här fallet returneras inga NDIS_SWITCH_NIC_PARAMETERS strukturer.

Anmärkningar

OID_SWITCH_NIC_ARRAY OID får endast utfärdas när Hyper-V utökningsbara växeln har slutfört aktiveringen. Mer information finns i Fråga Hyper-V Utökningsbar växelkonfiguration.

När tillägget bearbetar den returnerade NDIS_SWITCH_NIC_PARAMETERS-strukturen får det inte förutsätta att de olika strängmedlemmarna i NDIS_SWITCH_PORT_PARAMETERS-strukturen, till exempel NicFriendlyName, är NULL-avslutade. Datatyperna för dessa strängmedlemmar är typdefinierade av IF_COUNTED_STRING struktur. Drivrutinen måste fastställa stränglängden från värdet för Längd medlem i den här strukturen.

Obs Om strängen är null-avslutad får Längd medlem inte innehålla det avslutande null-tecknet.

Returstatuskoder

Den underliggande miniportgränsen för den utökningsbara växeln slutför OID-frågebegäran för OID_SWITCH_NIC_ARRAY och returnerar någon av följande statuskoder.

Statuskod	Beskrivning
NDIS_STATUS_SUCCESS	OID-begäran har slutförts.
NDIS_STATUS_INVALID_LENGTH	Informationsbuffertens längd är för liten för att returnera NDIS_SWITCH_NIC_ARRAY och dess matris med NDIS_SWITCH_NIC_PARAMETERS element. Den utökningsbara växelns underliggande miniportgräns anger DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.
NDIS_STATUS_FAILURE	Begäran misslyckades av andra skäl.

Krav

Version	Stöds i NDIS 6.30 och senare.
Rubrik	Ntddndis.h (inkludera Ndis.h)

Se även

---

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

fråga Hyper-V Utökningsbar växelkonfiguration