OID_SWITCH_NIC_ARRAY
Una extensión de conmutador extensible de Hyper-V emite una solicitud de consulta de identificador de objeto (OID) de OID_SWITCH_NIC_ARRAY para obtener una matriz. Cada elemento de la matriz especifica los parámetros de configuración de un adaptador de red virtual asociado a un puerto de conmutador extensible.
Si la solicitud de consulta OID se completa correctamente, el miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer contiene los siguientes datos:
Estructura NDIS_SWITCH_NIC_ARRAY que define el número de elementos de la matriz. Esta estructura también especifica el desplazamiento al primer elemento de la matriz.
Matriz de estructuras de NDIS_SWITCH_NIC_PARAMETERS . Cada una de estas estructuras contiene información sobre un adaptador de red que está conectado a un puerto de conmutador extensible.
Nota Si no hay adaptadores de red conectados a puertos de conmutador extensibles, el minipuerto subyacente del conmutador extensible establece el miembro NumElements de la estructura de NDIS_SWITCH_NIC_ARRAY en cero. En este caso, no se devuelve ninguna estructura NDIS_SWITCH_NIC_PARAMETERS .
Observaciones
El OID_SWITCH_NIC_ARRAY OID solo debe emitirse cuando el conmutador extensible de Hyper-V haya completado la activación. Consulte Consulta de la configuración del conmutador extensible de Hyper-V para obtener más detalles.
Cuando la extensión procesa la estructura de NDIS_SWITCH_NIC_PARAMETERS devuelta, no debe asumir que los distintos miembros de cadena de la estructura NDIS_SWITCH_PORT_PARAMETERS , como NicFriendlyName, terminan en NULL. Los tipos de datos de estos miembros de cadena se definen mediante la estructura IF_COUNTED_STRING . El controlador debe determinar la longitud de cadena del valor del miembro Length de esta estructura.
Nota Si la cadena termina en null, el miembro Length no debe incluir el carácter nulo de terminación.
Códigos de estado de devolución
El borde miniporte subyacente del conmutador extensible completa la solicitud de consulta OID de OID_SWITCH_NIC_ARRAY y 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_INVALID_LENGTH |
La longitud del búfer de información es demasiado pequeña para devolver el NDIS_SWITCH_NIC_ARRAY y su matriz de elementos NDIS_SWITCH_NIC_PARAMETERS . El borde de minipuerto subyacente del conmutador extensible establece 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) |
Consulte también
Consulta de la configuración del conmutador extensible de Hyper-V