NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES結構（ndis.h）

發行項
02/07/2025

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 指定為NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES之結構的 Type 成員。

若要指出 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

已 HardwareReceiveFilterCapabilities、CurrentReceiveFilterCapabilities、HardwareNicSwitchCapabilities，以及 CurrentNicSwitchCapabilities NDIS.20 的成員。

將 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）。

Note 如果此成員未設定為 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 服務質量的硬體功能。如果網路適配器不支援DCB的NDIS QoS硬體功能，此值可以 NULL。

如需詳細資訊，請參閱 NDIS QoS for Data Center 橋接。

注意如果此成員未設定為 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 參數。