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 controlador sobrecalado 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 de NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_NIC_SWITCH_CAPABILITIES.
Observaciones
A partir de NDIS 6.20, los controladores de miniporte 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 CurrentNicSwitchCapabilities miembro de la estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES en un puntero a la estructura de NDIS_NIC_SWITCH_CAPABILITIES. A continuación, el controlador de miniporta llama a la función NdisMSetMiniportAttributes y establece el parámetro MiniportAttributes en un puntero a una estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.
Nota a partir de NDIS 6.30, los controladores de miniporte 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 llamando a NdisMSetMiniportAttributes.
El protocolo excesivo y los controladores de filtro no tienen que emitir solicitudes de consulta 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 del conmutador NIC habilitadas actualmente de un adaptador de red subyacente a controladores de protocolo excesivo en la NicSwitchCapabilities miembro de la estructura de NDIS_BIND_PARAMETERS durante la operación de enlace.
NDIS informa de las funcionalidades de hardware de conmutador NIC actualmente habilitadas de un adaptador de red subyacente a controladores de filtro excesivos en la NicSwitchCapabilities miembro de la estructura de NDIS_FILTER_ATTACH_PARAMETERS durante la operación de conexión.
Códigos de estado de retorno
NDIS controla la solicitud de consulta OID de la solicitud de OID_NIC_SWITCH_CURRENT_CAPABILITIES para controladores de miniport. Los controladores no se emitirán esta solicitud de OID.
Cuando NDIS controla la solicitud de 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. El informationBuffer de apunta a una estructura de NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
El controlador miniport 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 miniport debe establecer 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 |
Se admite en NDIS 6.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |