Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un Hyper-V extensión de conmutador extensible 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 InformationBuffer miembro de la estructura de 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 ha creado ningún puerto en el conmutador extensible, el controlador establece el NumElements miembro 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 Hyper-V haya completado la activación. Consulte Consulta de la configuración de 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 suponer que los distintos miembros de cadena de la estructura de 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 longitud miembro de esta estructura.
Nota Si la cadena está terminada en null, el miembro Length de no debe incluir el carácter nulo de terminación.
Códigos de estado de retorno
El borde de minipuerto 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 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) |
Consulte también
Consulta de la configuración de conmutador extensible de Hyper-V