OID_NIC_SWITCH_CURRENT_CAPABILITIES
Un controlador demasiado excesivo emite una solicitud de consulta de identificador de objeto (OID) de OID_NIC_SWITCH_CURRENT_CAPABILITIES para obtener las funcionalidades de hardware habilitadas actualmente del conmutador NIC en un adaptador de red.
Después de una devolución correcta de la solicitud de consulta OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_CAPABILITIES .
Observaciones
A partir de NDIS 6.20, los controladores de minipuerto proporcionan las funcionalidades de hardware de conmutador NIC habilitadas actualmente en el adaptador de red cuando se llama a su función MiniportInitializeEx . El controlador inicializa una estructura de NDIS_NIC_SWITCH_CAPABILITIES con las funcionalidades de hardware del conmutador NIC y establece el miembro CurrentNicSwitchCapabilities de la estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES en un puntero a la estructura NDIS_NIC_SWITCH_CAPABILITIES . A continuación, el controlador de miniporte llama a la función NdisMSetMiniportAttributes y establece el parámetro MiniportAttributes en un puntero a una estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Nota A partir de NDIS 6.30, los controladores de minipuerto que admiten la interfaz de virtualización de E/S raíz única (SR-IOV) deben registrar las funcionalidades de hardware habilitadas del conmutador NIC. Los controladores registran estas funcionalidades mediante una llamada a NdisMSetMiniportAttributes.
El protocolo excesivo y los controladores de filtro no tienen que emitir solicitudes de consulta de OID de OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS proporciona las funcionalidades de hardware de conmutador NIC habilitadas actualmente de un adaptador de red a estos controladores de la siguiente manera:
NDIS informa de las funcionalidades de hardware de conmutador NIC habilitadas actualmente de un adaptador de red subyacente a controladores de protocolo excesivo en el miembro NicSwitchCapabilities de la estructura de NDIS_BIND_PARAMETERS durante la operación de enlace.
NDIS informa de las funcionalidades de hardware de conmutador NIC habilitadas actualmente de un adaptador de red subyacente para sobrescribir controladores de filtro en el miembro NicSwitchCapabilities de la estructura NDIS_FILTER_ATTACH_PARAMETERS durante la operación de conexión.
Códigos de estado de devolución
NDIS controla la solicitud de consulta OID de la solicitud de OID_NIC_SWITCH_CURRENT_CAPABILITIES para controladores de minipuerto. Los controladores no se emitirán esta solicitud de OID.
Cuando NDIS controla la solicitud OID_NIC_SWITCH_CURRENT_CAPABILITIES, devuelve uno de los siguientes códigos de estado:
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud se completó correctamente. InformationBuffer apunta a una estructura de NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
El controlador de minipuerto no admite la interfaz de virtualización de E/S raíz única (SR-IOV) o no está habilitada para usar la interfaz . |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es menor que sizeof(NDIS_NIC_SWITCH_CAPABILITIES). El controlador de minipuerto debe establecer 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.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |