OID_SWITCH_PORT_ARRAY
Ett Hyper-V utökningsbart växeltillägg utfärdar en OID-frågebegäran (object identifier) för OID_SWITCH_PORT_ARRAY för att hämta en matris. Varje element i matrisen anger konfigurationsparametrarna för 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_PORT_ARRAY struktur som definierar antalet element i matrisen.
En matris med NDIS_SWITCH_PORT_PARAMETERS strukturer. Var och en av dessa strukturer innehåller information om en port på den utökningsbara växeln.
Obs Om inga portar har skapats på den utökningsbara växeln anger drivrutinen NumElements medlem i NDIS_SWITCH_PORT_ARRAY-strukturen till noll och inga NDIS_SWITCH_PORT_PARAMETERS strukturer returneras.
Anmärkningar
OID_SWITCH_PORT_ARRAY OID får endast utfärdas när den 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 hanterar den returnerade NDIS_SWITCH_PORT_PARAMETERS-strukturen får det inte förutsätta att de olika strängmedlemmarna i den NDIS_SWITCH_PORT_PARAMETERS strukturen, till exempel PortName, ä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_PORT_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_PORT_ARRAY och dess matris med NDIS_SWITCH_PORT_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) |