OID_NIC_SWITCH_ENUM_SWITCHES
En överliggande drivrutin eller ett program i användarläge utfärdar en OID-frågebegäran (object identifier) för OID_NIC_SWITCH_ENUM_SWITCHES för att hämta en matris. Varje element i matrisen anger attributen för en nätverkskortsväxel som har skapats på ett nätverkskort.
Efter en lyckad retur från den här OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en buffert som innehåller följande:
En NDIS_NIC_SWITCH_INFO_ARRAY struktur som definierar antalet element i matrisen.
En matris med NDIS_NIC_SWITCH_INFO strukturer. Var och en av dessa strukturer innehåller information om en enda nätverkskortsväxel som skapats på nätverkskortet.
Obs Om nätverkskortet inte har några nätverkskortsväxlar anger drivrutinen NumElements medlem i NDIS_NIC_SWITCH_INFO_ARRAY-strukturen till noll och inga NDIS_NIC_SWITCH_INFO strukturer returneras.
Anmärkningar
Överliggande drivrutiner och program i användarläge utfärdar OID-frågebegäranden för OID_NIC_SWITCH_ENUM_SWITCHES för att räkna upp de nätverkskortsväxlar som skapats på ett nätverkskort.
Observera Från och med Windows Server 2012 stöder det enda rot-I/O-virtualiseringsgränssnittet (SR-IOV) endast standard-NIC-växeln på nätverkskortet. Därför måste den returnerade NDIS_NIC_SWITCH_INFO_ARRAY-strukturen ange ett enda NDIS_NIC_SWITCH_INFO element för standard-NIC-växeln, som refereras av identifieraren för NDIS_DEFAULT_SWITCH_ID.
Returstatuskoder
NDIS hanterar OID-frågebegäran för OID_NIC_SWITCH_ENUM_SWITCHES begäran för miniportdrivrutiner. Drivrutinerna kommer inte att utfärdas den här OID-begäran.
När NDIS hanterar OID_NIC_SWITCH_ENUM_SWITCHES begäran returneras någon av följande statuskoder.
| Statuskod | Beskrivning |
|---|---|
NDIS_STATUS_SUCCESS |
OID-begäran har slutförts. |
NDIS_STATUS_NOT_SUPPORTED |
Miniportdrivrutinen stöder antingen inte SR-IOV-gränssnittet eller så är den inte aktiverad för att använda gränssnittet. |
NDIS_STATUS_INVALID_PARAMETER |
En eller flera av medlemmarna i NDIS_NIC_SWITCH_INFO_ARRAY struktur har ogiltiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbufferten var för kort. NDIS 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) |