NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构 (ndis.h)

项目
02/26/2024

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES结构指定网络适配器的硬件辅助属性。

语法

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;

成员

Header

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的NDIS_OBJECT_HEADER结构。驱动程序将 Header 指定的结构的 Type 成员设置为NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES。

若要指示 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的版本，请将 Revision 成员设置为以下值之一：

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

为 NDIS 6.30 添加了各种成员。

将 Size 成员设置为 NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3。

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

为 NDIS 6.20 添加了 HardwareReceiveFilterCapabilities、 CurrentReceiveFilterCapabilities、 HardwareNicSwitchCapabilities 和 CurrentNicSwitchCapabilities 成员。

将 Size 成员设置为NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2。

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

NDIS 6.1 的原始版本。

将 Size 成员设置为NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1。

HDSplitAttributes

指向 NDIS_HD_SPLIT_ATTRIBUTES 结构的指针，该结构表示网络适配器提供的标头数据拆分功能。如果网络适配器不支持标头数据拆分功能，请将 HDSplitAttributes 设置为 NULL。

HardwareReceiveFilterCapabilities

指向的指针 NDIS_RECEIVE_FILTER_CAPABILITIES 结构。此结构指定网络适配器的硬件接收筛选功能。如果网络适配器不支持接收筛选，则此值可以为 NULL 。

警告如果此成员未设置为 NULL，则 CurrentReceiveFilterCapabilities 成员不得设置为 NULL。

CurrentReceiveFilterCapabilities

指向NDIS_RECEIVE_FILTER_CAPABILITIES结构的指针。此结构指定当前在网络适配器上启用的接收筛选功能。如果网络适配器不支持接收筛选，则此值可以为 NULL 。

警告如果此成员未设置为 NULL，则 HardwareReceiveFilterCapabilities 成员不得设置为 NULL。

HardwareNicSwitchCapabilities

指向的指针 NDIS_NIC_SWITCH_CAPABILITIES 结构。此结构指定网络适配器的硬件 NIC 交换机功能。如果网络适配器不支持 NIC 交换机功能或接收筛选，则此值可以为 NULL 。

警告如果此成员未设置为 NULL， 则 CurrentNicSwitchCapabilities 成员不得设置为 NULL。

CurrentNicSwitchCapabilities

指向 NDIS_NIC_SWITCH_CAPABILITIES 结构的指针。此结构指定当前在网络适配器上启用的 NIC 交换机功能。如果网络适配器不支持 NIC 交换机功能或接收筛选，则此值可以为 NULL 。

警告如果此成员未设置为 NULL，则 HardwareNicSwitchCapabilities 成员不得设置为 NULL。

HardwareSriovCapabilities

指向 NDIS_SRIOV_CAPABILITIES 结构的指针。此结构指定网络适配器硬件的单根 I/O 虚拟化 (SR-IOV) 功能。如果网络适配器不支持 SR-IOV，则此值可以为 NULL 。

有关 SR-IOV 的详细信息，请参阅单根 I/O 虚拟化 (SR-IOV) 。

注意如果此成员未设置为 NULL， 则 CurrentSriovCapabilities、 HardwareNicSwitchCapabilities 和 CurrentNicSwitchCapabilities 成员不得设置为 NULL。

CurrentSriovCapabilities

指向 NDIS_SRIOV_CAPABILITIES 结构的指针。此结构指定当前在网络适配器上启用的 SR-IOV 功能。如果网络适配器不支持 SR-IOV，则此值可以为 NULL 。

注意如果此成员未设置为 NULL，则 HardwareSriovCapabilities、 HardwareNicSwitchCapabilities 和 CurrentNicSwitchCapabilities 成员不得设置为 NULL。

HardwareQosCapabilities

指向 NDIS_QOS_CAPABILITIES 结构的指针。此结构指定网络适配器通过 IEEE 802.1 数据中心桥接 (DCB) 接口 (QoS) 为 NDIS 服务质量支持的硬件功能。如果网络适配器不支持 DCB 的 NDIS QoS 硬件功能，则此值可以为 NULL 。

有关详细信息，请参阅适用于数据中心桥接的 NDIS QoS。

注意如果此成员未设置为 NULL，则 CurrentQosCapabilities 成员不得设置为 NULL。

CurrentQosCapabilities

指向 NDIS_QOS_CAPABILITIES 结构的指针。此结构指定当前通过 DCB 接口在网络适配器上为 NDIS QoS 启用的硬件功能。如果网络适配器不支持 DCB 的 NDIS QoS 硬件功能，则此值可以为 NULL 。

如果适配器支持 NDIS QoS 功能，但禁用了这些功能，则微型端口驱动程序必须将除标头成员) 之外，NDIS_QOS_CAPABILITIES结构的所有成员 (设置为零。

注意如果此成员未设置为 NULL，则 HardwareQosCapabilities 成员不得设置为 NULL。

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

注解

若要注册基础网络适配器的硬件辅助功能，微型端口驱动程序会调用 NdisMSetMiniportAttributes 函数来自其 MiniportInitializeEx 函数。驱动程序将初始化 的 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构传递给此函数的 MiniportAttributes 参数。