NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構 (ndis.h)

發行項
04/18/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) 介面支援 NDIS 服務品質 (QoS) 的硬體功能。如果網路適配器不支援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 參數。