NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur (ndis.h)

Artikel
04/18/2024

Die NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur gibt die hardwaregestützten Attribute des Netzwerkadapters an.

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur . Der Treiber legt den Typmember der Struktur fest, die Header angibt, um NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Um die Version der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur anzugeben, legen Sie den Revisionsmember auf einen der folgenden Werte fest:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Verschiedene Member für NDIS 6.30 hinzugefügt.

Legen Sie das Element Größe auf NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3 fest.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Die Elemente HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities und CurrentNicSwitchCapabilities für NDIS 6.20 wurden hinzugefügt.

Legen Sie das Element Größe auf NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2 fest.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Originalversion für NDIS 6.1.

Legen Sie das Element Größe auf NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1 fest.

HDSplitAttributes

Ein Zeiger auf eine NDIS_HD_SPLIT_ATTRIBUTES Struktur, die die Vom Netzwerkadapter bereitgestellten Funktionen zum Teilen von Headern und Daten darstellt. Wenn der Netzwerkadapter die Funktion zum Teilen von Headerdaten nicht unterstützt, legen Sie HDSplitAttributes auf NULL fest.

HardwareReceiveFilterCapabilities

Ein Zeiger auf eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur. Diese Struktur gibt die Hardware-Empfangsfilterfunktionen des Netzwerkadapters an. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine Empfangsfilterung unterstützt.

Warnung Wenn dieser Member nicht auf NULL festgelegt ist, darf das CurrentReceiveFilterCapabilities-Element nicht auf NULL festgelegt werden.

CurrentReceiveFilterCapabilities

Ein Zeiger auf eine NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur. Diese Struktur gibt die Empfangsfilterfunktionen an, die derzeit auf dem Netzwerkadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine Empfangsfilterung unterstützt.

Warnung Wenn dieser Member nicht auf NULL festgelegt ist, darf der HardwareReceiveFilterCapabilities-Member nicht auf NULL festgelegt werden.

HardwareNicSwitchCapabilities

Ein Zeiger auf eine NDIS_NIC_SWITCH_CAPABILITIES Struktur. Diese Struktur gibt die Hardware-NIC-Switchfunktionen des Netzwerkadapters an. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine NIC-Switchfeatures oder Empfangsfilterung unterstützt.

Warnung Wenn dieser Member nicht auf NULL festgelegt ist, darf der CurrentNicSwitchCapabilities-Member nicht auf NULL festgelegt werden.

CurrentNicSwitchCapabilities

Ein Zeiger auf eine NDIS_NIC_SWITCH_CAPABILITIES-Struktur . Diese Struktur gibt die NIC-Switchfunktionen an, die derzeit auf dem Netzwerkadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine NIC-Switchfeatures oder Empfangsfilterung unterstützt.

Warnung Wenn dieser Member nicht auf NULL festgelegt ist, darf der HardwareNicSwitchCapabilities-Member nicht auf NULL festgelegt werden.

HardwareSriovCapabilities

Ein Zeiger auf eine NDIS_SRIOV_CAPABILITIES-Struktur . Diese Struktur gibt die S/A-Virtualisierungsfunktionen (Single Root I/O Virtualization, SR-IOV) der Netzwerkadapterhardware an. Dieser Wert kann NULL sein, wenn der Netzwerkadapter SR-IOV nicht unterstützt.

Weitere Informationen zu SR-IOV finden Sie unter Single Root E/O Virtualization (SR-IOV).

Hinweis Wenn dieser Member nicht auf NULL festgelegt ist, dürfen die Member CurrentSriovCapabilities, HardwareNicSwitchCapabilities und CurrentNicSwitchCapabilities nicht auf NULL festgelegt werden.

CurrentSriovCapabilities

Ein Zeiger auf eine NDIS_SRIOV_CAPABILITIES-Struktur . Diese Struktur gibt die SR-IOV-Funktionen an, die derzeit auf dem Netzwerkadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Netzwerkadapter SR-IOV nicht unterstützt.

Hinweis Wenn dieser Member nicht auf NULL festgelegt ist, dürfen die Elemente HardwareSriovCapabilities, HardwareNicSwitchCapabilities und CurrentNicSwitchCapabilities nicht auf NULL festgelegt werden.

HardwareQosCapabilities

Ein Zeiger auf eine NDIS_QOS_CAPABILITIES-Struktur . Diese Struktur gibt die Hardwarefunktionen an, die der Netzwerkadapter für NDIS Quality of Service (QoS) über die IEEE 802.1 Data Center Bridging (DCB)-Schnittstelle unterstützt. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine NDIS QoS-Hardwarefunktionen für DCB unterstützt.

Weitere Informationen finden Sie unter NDIS QoS for Data Center Bridging.

Hinweis Wenn dieser Member nicht auf NULL festgelegt ist, darf der CurrentQosCapabilities-Member nicht auf NULL festgelegt werden.

CurrentQosCapabilities

Ein Zeiger auf eine NDIS_QOS_CAPABILITIES-Struktur . Diese Struktur gibt die Hardwarefunktionen an, die derzeit auf dem Netzwerkadapter für NDIS QoS über die DCB-Schnittstelle aktiviert sind. Dieser Wert kann NULL sein, wenn der Netzwerkadapter keine NDIS QoS-Hardwarefunktionen für DCB unterstützt.

Wenn der Adapter QoS-Funktionen von NDIS unterstützt, diese jedoch deaktiviert sind, muss der Miniporttreiber alle Member der NDIS_QOS_CAPABILITIES-Struktur (mit Ausnahme des Headerelements ) auf 0 (null) festlegen.

Hinweis Wenn dieser Member nicht auf NULL festgelegt ist, darf der HardwareQosCapabilities-Member nicht auf NULL festgelegt werden.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Hinweise

Um die hardwareunterstützten Funktionen des zugrunde liegenden Netzwerkadapters zu registrieren, ruft der Miniporttreiber die NdisMSetMiniportAttributes-Funktion aus der MiniportInitializeEx-Funktion . Der Treiber übergibt eine initialisierte NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur an den MiniportAttributes-Parameter dieser Funktion.