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 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 de 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 de avanzadas de.
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 miniporte 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 HardwareNicSwitchCapabilities 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 del conmutador NIC. Los controladores registran estas funcionalidades llamando a NdisMSetMiniportAttributes.
Códigos de estado de retorno
NDIS controla la solicitud de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES solicitud de controladores de miniport y 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). NDIS establece 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) |