OID_NIC_SWITCH_ENUM_SWITCHES
Una aplicación en modo de usuario o controlador excesiva emite una solicitud de consulta de identificador de objeto (OID) de OID_NIC_SWITCH_ENUM_SWITCHES para obtener una matriz. Cada elemento de la matriz especifica los atributos de un conmutador NIC que se ha creado en un adaptador de red.
Después de una devolución correcta de esta solicitud de consulta OID, el informationBuffer miembro de la estructura de NDIS_OID_REQUEST contiene un puntero a un búfer que contiene lo siguiente:
Estructura NDIS_NIC_SWITCH_INFO_ARRAY que define el número de elementos de la matriz.
Matriz de estructuras de NDIS_NIC_SWITCH_INFO. Cada una de estas estructuras contiene la información sobre un único conmutador NIC creado en el adaptador de red.
Nota Si el adaptador de red no tiene conmutadores NIC, el controlador establece el NumElements miembro de la estructura de NDIS_NIC_SWITCH_INFO_ARRAY en cero y no se devuelven estructuras NDIS_NIC_SWITCH_INFO.
Observaciones
El uso excesivo de controladores y aplicaciones en modo de usuario emite solicitudes de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES para enumerar los conmutadores de NIC creados en un adaptador de red.
Nota a partir de Windows Server 2012, la interfaz de virtualización de E/S raíz única (SR-IOV) solo admite el conmutador NIC predeterminado en el adaptador de red. Por lo tanto, la estructura de NDIS_NIC_SWITCH_INFO_ARRAY devuelta debe especificar un único elemento NDIS_NIC_SWITCH_INFO para el modificador NIC predeterminado, al que hace referencia el identificador de NDIS_DEFAULT_SWITCH_ID.
Códigos de estado de retorno
NDIS controla la solicitud de consulta OID de la solicitud de OID_NIC_SWITCH_ENUM_SWITCHES para controladores de miniport. Los controladores no se emitirán esta solicitud de OID.
Cuando NDIS controla la solicitud OID_NIC_SWITCH_ENUM_SWITCHES, devuelve uno de los siguientes códigos de estado.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud OID se completó correctamente. |
NDIS_STATUS_NOT_SUPPORTED |
El controlador miniport no admite la interfaz SR-IOV o no está habilitada para usar la interfaz . |
NDIS_STATUS_INVALID_PARAMETER |
Uno o varios de los miembros de la estructura de NDIS_NIC_SWITCH_INFO_ARRAY tienen valores no válidos. |
NDIS_STATUS_INVALID_LENGTH |
El búfer de información era demasiado corto. NDIS establece el DATA. QUERY_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario. |
NDIS_STATUS_FAILURE |
Error en la solicitud por otros motivos. |
Requisitos
Versión |
Compatible con NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |