OID_SWITCH_PARAMETERS
Una extensión de conmutador extensible de Hyper-V emite una solicitud de consulta de identificador de objeto (OID) de OID_SWITCH_PARAMETERS para obtener los datos de configuración del conmutador extensible.
Si la solicitud de consulta OID se completa correctamente, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_SWITCH_PARAMETERS .
Observaciones
Cuando la extensión procesa la estructura de NDIS_SWITCH_PARAMETERS devuelta, no debe suponer que los distintos miembros de cadena de la estructura NDIS_SWITCH_PARAMETERS , como SwitchName, terminan en null. Los tipos de datos de estos miembros de cadena se definen mediante la estructura IF_COUNTED_STRING . La extensión 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 de minipuerto subyacente del conmutador extensible completa la solicitud de consulta OID de OID_SWITCH_PARAMETERS y devuelve uno de los siguientes códigos de estado.
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud de OID se completó correctamente. |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es demasiado pequeña para devolver la estructura de OID_SWITCH_PARAMETERS para una solicitud de consulta OID. El borde de minipuerto subyacente del conmutador extensible establece data . QUERY_INFORMATION. Miembro BytesNeeded 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 |
Se admite en NDIS 6.30 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |