NDIS_OFFLOAD_ENCAPSULATION-Struktur (ndis/encapsulationconfig.h)

  • Artikel

Die NDIS_OFFLOAD_ENCAPSULATION-Struktur gibt Kapselungseinstellungen an, wenn sie mit der OID_OFFLOAD_ENCAPSULATION OID verwendet wird.

Syntax

typedef struct _NDIS_OFFLOAD_ENCAPSULATION {
  NDIS_OBJECT_HEADER Header;
  struct {
    ULONG Enabled;
    ULONG EncapsulationType;
    ULONG HeaderSize;
  } IPv4;
  struct {
    ULONG Enabled;
    ULONG EncapsulationType;
    ULONG HeaderSize;
  } IPv6;
} NDIS_OFFLOAD_ENCAPSULATION, *PNDIS_OFFLOAD_ENCAPSULATION;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_OFFLOAD_ENCAPSULATION-Struktur. Legen Sie den Typmember der Struktur, die Header für NDIS_OBJECT_TYPE_OFFLOAD_ENCAPSULATION angibt, das Revisionselement auf NDIS_OFFLOAD_ENCAPSULATION_ REVISION _1 und das Size-Element auf NDIS_SIZEOF_OFFLOAD_ENCAPSULATION_REVISION_1 fest.

IPv4

Eine Struktur innerhalb NDIS_OFFLOAD_ENCAPSULATION, die die IPv4-Kapselung angibt und die die folgenden Member enthält:

IPv4.Enabled

Ein ULONG-Wert, der die IPv4-Kapselung ermöglicht. Ein Protokolltreiber legt Enabled auf NDIS_OFFLOAD_SET_ON fest, wenn er IPv4 large send offload Version 1 (LSOV1), Large Send Offload Version 2 (LSOV2) oder Prüfsummenauslagerungen aktiviert. Wenn ein Protokolltreiber alle Auslagerungen deaktiviert, wird Enabled auf NDIS_OFFLOAD_SET_OFF festgelegt. Andernfalls legt der Protokolltreiber Enabled auf NDIS_OFFLOAD_SET_NO_CHANGE fest.

IPv4.EncapsulationType

Der IPv4-Kapselungstyp. Wenn der Enabled-Member nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieser Member null. Wenn das Enabled-Element auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber EncapsulationType auf einen der folgenden Elemente festlegen:

Wert Bedeutung
NDIS_ENCAPSULATION_IEEE_802_3
 Gibt die IEEE 802.3-Kapselung an. Wenn dieser Wert angegeben wird, sollte ein Miniporttreiber ggf. auch NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q oder NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB Kapselung verwenden. Weitere Informationen finden Sie in der Dokumentation für NDIS_OFFLOAD.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
 Gibt die LLC-Kapselung (Logical Link Control) für Routingprotokolle an, wie in RFC 1483 beschrieben. Dieses Flag wird auch verwendet, um die Ethernet LLC/SNAP-Kapselung anzugeben.

IPv4.HeaderSize

Die Länge des Ethernet-Headers, die in IPv4-Paketen verwendet wird. Wenn der Enabled-Member nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieser Member null. Wenn das Element Enabled auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber HeaderSize auf die Größe des ethernet-Headers festlegen, den er verwendet.

IPv6

Eine Struktur innerhalb NDIS_OFFLOAD_ENCAPSULATION, die die IPv6-Kapselung angibt und die die folgenden Member enthält:

IPv6.Enabled

Ein ULONG-Wert, der die IPv6-Kapselung ermöglicht. Ein Protokolltreiber legt Enabled auf NDIS_OFFLOAD_SET_ON fest, wenn er IPv6 LSOV1-, LSOV2- oder Prüfsummenauslagerungen aktiviert. Wenn ein Protokolltreiber alle Auslagerungen deaktiviert, wird Enabled auf NDIS_OFFLOAD_SET_OFF festgelegt. Andernfalls legt der Protokolltreiber Enabled auf NDIS_OFFLOAD_SET_NO_CHANGE fest.

IPv6.EncapsulationType

Der IPv6-Kapselungstyp. Wenn der Enabled-Member nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist EncapsulationType null. Wenn das Enabled-Element auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber EncapsulationType auf einen der folgenden Elemente festlegen:

Wert Bedeutung
NDIS_ENCAPSULATION_IEEE_802_3
 Gibt die IEEE 802.3-Kapselung an. Wenn dieser Wert angegeben wird, sollte ein Miniporttreiber ggf. auch NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q oder NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB Kapselung verwenden. Weitere Informationen finden Sie in der Dokumentation für NDIS_OFFLOAD.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
 Gibt die LLC-Kapselung für Routingprotokolle an, wie in RFC 1483 beschrieben. Dieses Flag wird auch verwendet, um die Ethernet LLC/SNAP-Kapselung anzugeben.

IPv6.HeaderSize

Die Länge des Ethernet-Headers, die in IPv6-Paketen verwendet wird. Wenn der Enabled-Member nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieser Member null. Wenn das Element Enabled auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber HeaderSize auf die Größe des ethernet-Headers festlegen, den er verwendet.

Hinweise

Die NDIS_OFFLOAD_ENCAPSULATION-Struktur gibt die angeforderten Kapselungseinstellungen an, die ein Miniportadapter für Aufgabenauslagerungsdienste verwenden soll.

In einer Reihe von OID_OFFLOAD_ENCAPSULATION gibt ein Protokolltreiber eine NDIS_OFFLOAD_ENCAPSULATION-Struktur im InformationBuffer-Member der NDIS_OID_REQUEST-Struktur an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Kopfzeile ndis/encapsulationconfig.h (include ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_OFFLOAD_ENCAPSULATION