NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structure (ndis.h)

Article
05/26/2021

The NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structure specifies the hardware-assisted attributes of the network adapter.

Syntax

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;

Members

Header

The NDIS_OBJECT_HEADER structure for the NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structure. The driver sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

To indicate the version of the NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structure, set the Revision member to one of the following values:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Added various members for NDIS 6.30.

Set the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Added the HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities, and CurrentNicSwitchCapabilities members for NDIS 6.20.

Set the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Original version for NDIS 6.1.

Set the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1.

HDSplitAttributes

A pointer to an NDIS_HD_SPLIT_ATTRIBUTES structure that represents the header-data split capabilities that the network adapter provides. If the network adapter does not support the header-data split feature, set HDSplitAttributes to NULL.

HardwareReceiveFilterCapabilities

A pointer to an NDIS_RECEIVE_FILTER_CAPABILITIES structure. This structure specifies the hardware receive filtering capabilities of the network adapter. This value can be NULL if the network adapter does not support receive filtering.

Warning If this member is not set to NULL, the CurrentReceiveFilterCapabilities member must not be set to NULL.

CurrentReceiveFilterCapabilities

A pointer to an NDIS_RECEIVE_FILTER_CAPABILITIES structure. This structure specifies the receive filtering capabilities that are currently enabled on the network adapter. This value can be NULL if the network adapter does not support receive filtering.

Warning If this member is not set to NULL, the HardwareReceiveFilterCapabilities member must not be set to NULL.

HardwareNicSwitchCapabilities

A pointer to an NDIS_NIC_SWITCH_CAPABILITIES structure. This structure specifies the hardware NIC switch capabilities of the network adapter. This value can be NULL if the network adapter does not support NIC switch features or receive filtering.

Warning If this member is not set to NULL, the CurrentNicSwitchCapabilities member must not be set to NULL.

CurrentNicSwitchCapabilities

A pointer to an NDIS_NIC_SWITCH_CAPABILITIES structure. This structure specifies the NIC switch capabilities that are currently enabled on the network adapter. This value can be NULL if the network adapter does not support NIC switch features or receive filtering.

Warning If this member is not set to NULL, the HardwareNicSwitchCapabilities member must not be set to NULL.

HardwareSriovCapabilities

A pointer to an NDIS_SRIOV_CAPABILITIES structure. This structure specifies the single root I/O virtualization (SR-IOV) capabilities of the network adapter hardware. This value can be NULL if the network adapter does not support SR-IOV.

For more information on SR-IOV, see Single Root I/O Virtualization (SR-IOV).

Note If this member is not set to NULL, the CurrentSriovCapabilities, HardwareNicSwitchCapabilities, and CurrentNicSwitchCapabilities members must not be set to NULL.

CurrentSriovCapabilities

A pointer to an NDIS_SRIOV_CAPABILITIES structure. This structure specifies the SR-IOV capabilities that are currently enabled on the network adapter. This value can be NULL if the network adapter does not support SR-IOV.

Note If this member is not set to NULL, the HardwareSriovCapabilities, HardwareNicSwitchCapabilities, and CurrentNicSwitchCapabilities members must not be set to NULL.

HardwareQosCapabilities

A pointer to an NDIS_QOS_CAPABILITIES structure. This structure specifies the hardware capabilities that the network adapter supports for NDIS quality of service (QoS) over the IEEE 802.1 Data Center Bridging (DCB) interface. This value can be NULL if the network adapter does not support NDIS QoS hardware capabilities for DCB.

For more information, see NDIS QoS for Data Center Bridging.

Note If this member is not set to NULL, the CurrentQosCapabilities member must not be set to NULL.

CurrentQosCapabilities

A pointer to an NDIS_QOS_CAPABILITIES structure. This structure specifies the hardware capabilities that are currently enabled on the network adapter for NDIS QoS over the DCB interface. This value can be NULL if the network adapter does not support NDIS QoS hardware capabilities for DCB.

If the adapter supports NDIS QoS capabilities but those capabilities are disabled, the miniport driver must set all members of the NDIS_QOS_CAPABILITIES structure (with the exception of the Header member) to zero.

Note If this member is not set to NULL, the HardwareQosCapabilities member must not be set to NULL.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Remarks

To register the hardware-assisted capabilities of the underlying network adapter, the miniport driver calls the NdisMSetMiniportAttributes function from its MiniportInitializeEx function. The driver passes an initialized NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES structure to the MiniportAttributes parameter of this function.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Header	ndis.h (include Ndis.h)