OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Un controlador demasiado excesivo emite una solicitud de consulta de identificador de objeto (OID) de OID_NIC_SWITCH_HARDWARE_CAPABILITIES para obtener las funcionalidades de hardware del conmutador NIC en el 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
La estructura NDIS_NIC_SWITCH_CAPABILITIES contiene información sobre las funcionalidades de hardware de un conmutador NIC en el adaptador de red. Estas funcionalidades pueden incluir las funcionalidades de hardware deshabilitadas actualmente por la configuración del archivo INF o a través de la página De propiedades avanzadas .
Nota Todas las funcionalidades del conmutador NIC especificado se devuelven a través de una solicitud de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES, independientemente de si una funcionalidad está habilitada o deshabilitada.
A partir de NDIS 6.20, los controladores de minipuerto proporcionan las funcionalidades de hardware del conmutador NIC 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 HardwareNicSwitchCapabilities 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 del conmutador NIC. Los controladores registran estas funcionalidades mediante una llamada a NdisMSetMiniportAttributes.
Códigos de estado de devolución
NDIS controla la solicitud de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES solicitud de controladores de miniporte y 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). NDIS 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.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |