OID_SWITCH_PORT_ARRAY
Una extensión de conmutador extensible de Hyper-V emite una solicitud de consulta de identificador de objeto (OID) de OID_SWITCH_PORT_ARRAY para obtener una matriz. Cada elemento de la matriz especifica los parámetros de configuración de un puerto de conmutador extensible.
Si la solicitud de consulta OID se completa correctamente, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer contiene los siguientes datos:
Estructura NDIS_SWITCH_PORT_ARRAY que define el número de elementos de la matriz.
Matriz de estructuras de NDIS_SWITCH_PORT_PARAMETERS . Cada una de estas estructuras contiene información sobre un puerto en el conmutador extensible.
Nota Si no se han creado puertos en el conmutador extensible, el controlador establece el miembro NumElements de la estructura de NDIS_SWITCH_PORT_ARRAY en cero y no se devuelve ninguna estructura NDIS_SWITCH_PORT_PARAMETERS .
Observaciones
El OID_SWITCH_PORT_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 controla la estructura de NDIS_SWITCH_PORT_PARAMETERS devuelta, no debe asumir que los distintos miembros de cadena de la estructura NDIS_SWITCH_PORT_PARAMETERS , como PortName, 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_PORT_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_PORT_ARRAY y su matriz de elementos NDIS_SWITCH_PORT_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