OID_SWITCH_PORT_ARRAY

Artículo
06/15/2023

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

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

Consulta de la configuración del conmutador extensible de Hyper-V