NDIS_HD_SPLIT_CURRENT_CONFIG-Struktur (ntddndis.h)

  • Artikel

Die NDIS_HD_SPLIT_CURRENT_CONFIG-Struktur stellt die aktuelle Header-Daten-Split-Konfiguration eines Miniportadapters bereit.

Syntax

typedef struct _NDIS_HD_SPLIT_CURRENT_CONFIG {
  NDIS_OBJECT_HEADER Header;
  ULONG              HardwareCapabilities;
  ULONG              CurrentCapabilities;
  ULONG              HDSplitFlags;
  ULONG              HDSplitCombineFlags;
  ULONG              BackfillSize;
  ULONG              MaxHeaderSize;
} NDIS_HD_SPLIT_CURRENT_CONFIG, *PNDIS_HD_SPLIT_CURRENT_CONFIG;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_HD_SPLIT_CURRENT_CONFIG-Struktur. Der Treiber legt den Typmember der Struktur, den Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT, den Revisionsmember auf NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1 und das Size-Element auf NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1 fest.

HardwareCapabilities

Die Vom Miniportadapter unterstützten Hardwarefunktionen für header-datenaufteilen. Diese Funktionen sollten Funktionen umfassen, die derzeit von den INF-Dateieinstellungen oder über die Seite Erweiterte Eigenschaften deaktiviert sind. Der Wert von HardwareCapabilities ist ein bitweises OR der folgenden Flags:

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

Der Miniportadapter kann den Header und die Daten in separate Speicherdeskriptorlisten (Memory Descriptor Lists, MDLs) aufteilen, die die Anforderungen für die Unterstützung für die Aufteilung von Headerdaten erfüllen.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

Der Miniportadapter kann IPv4-Ethernet-Frames teilen, die IPv4-Optionen enthalten. Der Miniportadapter kann das Aufteilen einiger IPv4-Optionen unterstützen, während andere nicht aufgeteilt werden.

Hinweis Die NIC darf keine IPv4-Frames teilen, die nicht unterstützte IPv4-Optionen enthalten. Wenn ein IPv4-Frame geteilt wird, muss der Headerteil des geteilten Frames den gesamten IPv4-Header und alle vorhandenen IPv4-Optionen enthalten.
 

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

Der Miniportadapter kann IPv6-Ethernet-Frames teilen, die IPv6-Erweiterungsheader enthalten. Der Miniportadapter kann einige IPv6-Erweiterungsheader unterstützen, andere jedoch nicht.

Hinweis Die NIC darf keine IPv6-Frames teilen, die nicht unterstützte IPv6-Erweiterungsheader enthalten. Wenn ein IPv6-Frame geteilt wird, muss der Headerteil des geteilten Frames den gesamten IPv6-Header und alle vorhandenen IPv6-Erweiterungsheader enthalten.
 

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

Der Miniportadapter kann TCP-Frames zusätzlich zur Timestamp-Option mit anderen TCP-Optionen aufteilen. Der Miniportadapter kann einige TCP-Optionen unterstützen, andere nicht.

Hinweis Wenn die einzige TCP-Option in einem Frame die Zeitstempeloption ist, muss der Datenteilungsanbieter in der Lage sein, den Frame aufzuteilen.
 
Hinweis Wenn ein TCP-Header eine nicht unterstützte TCP-Option enthält, muss die NIC den Frame am Anfang des TCP-Headers teilen oder darf den Frame nicht teilen.
 

CurrentCapabilities

Die aktuellen Header-Daten-Split-Funktionen, die der Miniportadapter unterstützt. Der Miniporttreiber verwendet die gleichen Flags, die für den HardwareCapabilities-Member definiert sind. In diesem Fall werden die Flags festgelegt, um die aktuellen Funktionen anzugeben, die von den aktuellen Konfigurationseinstellungen abhängen.

HDSplitFlags

Eine Gruppe von Flags, die die status der Header-Datenteilung für einen Miniportadapter meldet. NDIS legt diesen Member mit einem bitweisen OR der folgenden Flags fest:

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Der Miniporttreiber hat die Aufteilung von Headerdaten in der Hardware aktiviert. Andernfalls ist die Aufteilung von Headerdaten deaktiviert.

HDSplitCombineFlags

Ein Satz von Flags, die die aktuellen Einstellungen für die Aufteilung von Headerdaten eines Miniportadapters angeben. Der Wert von HDSplitCombineFlags kann ein bitweises OR der folgenden Flags sein:

NDIS_HD_SPLIT_COMBINE_ALL_HEADERS

Der Miniportadapter kombiniert geteilte Frames. Wenn die Aufteilung von Headerdaten in der Hardware aktiviert ist, sollte der Miniporttreiber den Header und die Daten kombinieren, bevor der Frame für NDIS angegeben wird.

BackfillSize

Die Ausfüllgröße in Bytes, die der Miniporttreiber für den Datenteil eines geteilten Frames verwendet.

MaxHeaderSize

Die maximale Größe in Bytes, die der Miniporttreiber für den Headerteil eines geteilten Frames verwendet.

Hinweis Wenn die Länge eines Headers MaxHeaderSize überschreitet, da IPv4-Optionen, IPsec-Header oder IPv6-Erweiterungsheader vorhanden sind, darf der Frame nicht aufgeteilt werden. Wenn ein Header, der einen TCP- oder UDP-Header enthält, MaxHeaderSize aufgrund des Vorhandenseins von TCP-Header, TCP-Optionen oder UDP-Headern überschreitet, muss die NIC den Frame am Anfang des Protokollheaders der oberen Ebene teilen oder darf den Frame nicht teilen.
 

Hinweise

Die NDIS_HD_SPLIT_CURRENT_CONFIG-Struktur wird im OID_GEN_HD_SPLIT_CURRENT_CONFIG OID-Abfrageanforderung zum Abrufen der aktuellen Header-Daten-Split-Konfiguration eines Miniportadapters.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.1 und höher.
Kopfzeile ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG