estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES (ndis.h)

Artículo
08/07/2023

La estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES especifica los atributos asistidos por hardware del adaptador de red.

Sintaxis

typedef struct _NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_HD_SPLIT_ATTRIBUTES         HDSplitAttributes;
  PNDIS_RECEIVE_FILTER_CAPABILITIES HardwareReceiveFilterCapabilities;
  PNDIS_RECEIVE_FILTER_CAPABILITIES CurrentReceiveFilterCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     HardwareNicSwitchCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     CurrentNicSwitchCapabilities;
  PNDIS_SRIOV_CAPABILITIES          HardwareSriovCapabilities;
  PNDIS_SRIOV_CAPABILITIES          CurrentSriovCapabilities;
  PNDIS_QOS_CAPABILITIES            HardwareQosCapabilities;
  PNDIS_QOS_CAPABILITIES            CurrentQosCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    HardwareGftOffloadCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    CurrentGftOffloadCapabilities;
} NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . El controlador establece el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Para indicar la versión de la estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES , establezca el miembro Revision en uno de los valores siguientes:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Se agregaron varios miembros para NDIS 6.30.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Se agregaron los miembros HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities y CurrentNicSwitchCapabilities para NDIS 6.20.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Versión original de NDIS 6.1.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1.

HDSplitAttributes

Puntero a una estructura NDIS_HD_SPLIT_ATTRIBUTES que representa las funcionalidades de división de datos de encabezado que proporciona el adaptador de red. Si el adaptador de red no admite la característica de división de datos de encabezado, establezca HDSplitAttributes en NULL.

HardwareReceiveFilterCapabilities

Puntero a un NDIS_RECEIVE_FILTER_CAPABILITIES estructura. Esta estructura especifica las funcionalidades de filtrado de recepción de hardware del adaptador de red. Este valor puede ser NULL si el adaptador de red no admite el filtrado de recepción.

Advertencia Si este miembro no está establecido en NULL, el miembro CurrentReceiveFilterCapabilities no debe establecerse en NULL.

CurrentReceiveFilterCapabilities

Puntero a una estructura NDIS_RECEIVE_FILTER_CAPABILITIES. Esta estructura especifica las funcionalidades de filtrado de recepción que están habilitadas actualmente en el adaptador de red. Este valor puede ser NULL si el adaptador de red no admite el filtrado de recepción.

Advertencia Si este miembro no está establecido en NULL, el miembro HardwareReceiveFilterCapabilities no debe establecerse en NULL.

HardwareNicSwitchCapabilities

Puntero a un NDIS_NIC_SWITCH_CAPABILITIES estructura. Esta estructura especifica las funcionalidades del conmutador NIC de hardware del adaptador de red. Este valor puede ser NULL si el adaptador de red no admite características de conmutador NIC ni filtrado de recepción.

Advertencia Si este miembro no está establecido en NULL, el miembro CurrentNicSwitchCapabilities no debe establecerse en NULL.

CurrentNicSwitchCapabilities

Puntero a una estructura de NDIS_NIC_SWITCH_CAPABILITIES . Esta estructura especifica las funcionalidades del conmutador NIC que están habilitadas actualmente en el adaptador de red. Este valor puede ser NULL si el adaptador de red no admite características de conmutador NIC ni filtrado de recepción.

Advertencia Si este miembro no está establecido en NULL, el miembro HardwareNicSwitchCapabilities no debe establecerse en NULL.

HardwareSriovCapabilities

Puntero a una estructura NDIS_SRIOV_CAPABILITIES . Esta estructura especifica las funcionalidades de virtualización de E/S raíz única (SR-IOV) del hardware del adaptador de red. Este valor puede ser NULL si el adaptador de red no admite SR-IOV.

Para obtener más información sobre SR-IOV, consulte Virtualización de E/S raíz única (SR-IOV).

Nota Si este miembro no está establecido en NULL, los miembros CurrentSriovCapabilities, HardwareNicSwitchCapabilities y CurrentNicSwitchCapabilities no deben establecerse en NULL.

CurrentSriovCapabilities

Puntero a una estructura NDIS_SRIOV_CAPABILITIES . Esta estructura especifica las funcionalidades sr-IOV que están habilitadas actualmente en el adaptador de red. Este valor puede ser NULL si el adaptador de red no admite SR-IOV.

Nota Si este miembro no está establecido en NULL, los miembros HardwareSriovCapabilities, HardwareNicSwitchCapabilities y CurrentNicSwitchCapabilities no deben establecerse en NULL.

HardwareQosCapabilities

Puntero a una estructura de NDIS_QOS_CAPABILITIES . Esta estructura especifica las funcionalidades de hardware que admite el adaptador de red para la calidad de servicio (QoS) NDIS a través de la interfaz IEEE 802.1 Data Center Bridging (DCB). Este valor puede ser NULL si el adaptador de red no admite funcionalidades de hardware QoS de NDIS para DCB.

Para obtener más información, consulte NDIS QoS for Data Center Bridging.

Nota Si este miembro no está establecido en NULL, el miembro CurrentQosCapabilities no debe establecerse en NULL.

CurrentQosCapabilities

Puntero a una estructura de NDIS_QOS_CAPABILITIES . Esta estructura especifica las funcionalidades de hardware que están habilitadas actualmente en el adaptador de red para QoS de NDIS a través de la interfaz DCB. Este valor puede ser NULL si el adaptador de red no admite funcionalidades de hardware QoS de NDIS para DCB.

Si el adaptador admite NDIS QoS capabilties, pero esas funcionalidades están deshabilitadas, el controlador de minipuerto debe establecer todos los miembros de la estructura NDIS_QOS_CAPABILITIES (con la excepción del miembro Header ) en cero.

Nota Si este miembro no está establecido en NULL, el miembro HardwareQosCapabilities no debe establecerse en NULL.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Comentarios

Para registrar las funcionalidades asistidas por hardware del adaptador de red subyacente, el controlador de minipuerto llama al Función NdisMSetMiniportAttributes de su función MiniportInitializeEx . El controlador pasa una estructura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES inicializada al parámetro MiniportAttributes de esta función.