Auf Englisch lesen

Freigeben über


NDIS_OFFLOAD_ENCAPSULATION Struktur (ndis/encapsulationconfig.h)

Die NDIS_OFFLOAD_ENCAPSULATION Struktur gibt Kapselungseinstellungen an, wenn sie mit dem 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;

Angehörige

Header

Die NDIS_OBJECT_HEADER Struktur für die NDIS_OFFLOAD_ENCAPSULATION Struktur. Legen Sie das element Type der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_OFFLOAD_ENCAPSULATION, das element Revision auf NDIS_OFFLOAD_ENCAPSULATION_ REVISION _1 und das Size Member auf NDIS_SIZEOF_OFFLOAD_ENCAPSULATION_REVISION_1.

IPv4

Eine Struktur innerhalb NDIS_OFFLOAD_ENCAPSULATION, 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 Aktivierte auf NDIS_OFFLOAD_SET_ON fest, wenn IPv4 large send offload Version 1 (LSOV1), Large Send Offload Version 2 (LSOV2) oder Prüfsummenabladungen aktiviert werden. 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 das element "Aktiviert" nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieses Element null. Wenn das element Enabled auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber EncapsulationType- auf einen der folgenden Werte festlegen:

Wert Bedeutung
NDIS_ENCAPSULATION_IEEE_802_3
Gibt 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 zu NDIS_OFFLOAD.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
Gibt die Kapselung für Routingprotokolle (Logical Link Control, LLC) an, wie in RFC 1483 beschrieben. Dieses Flag wird auch verwendet, um ethernet LLC/SNAP-Kapselung anzugeben.

IPv4.HeaderSize

Die Länge des Ethernet-Headers, die in IPv4-Paketen verwendet wird. Wenn das element "Aktiviert" nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieses Element null. Wenn das element "Enabled" auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber HeaderSize- auf die Größe des von ihr verwendeten Ethernet-Headers festlegen.

IPv6

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

IPv6.Enabled

Ein ULONG-Wert, der die IPv6-Kapselung ermöglicht. Ein Protokolltreiber legt Enabled auf NDIS_OFFLOAD_SET_ON fest, wenn IPv6 LSOV1, LSOV2 oder Checkum offloads aktiviert wird. 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 das element Enabled nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist EncapsulationType null. Wenn das element Enabled auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber EncapsulationType- auf einen der folgenden Werte festlegen:

Wert Bedeutung
NDIS_ENCAPSULATION_IEEE_802_3
Gibt 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 zu 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 ethernet LLC/SNAP-Kapselung anzugeben.

IPv6.HeaderSize

Die Länge des Ethernet-Headers, die in IPv6-Paketen verwendet wird. Wenn das element "Aktiviert" nicht auf NDIS_OFFLOAD_SET_ON festgelegt ist, ist dieses Element null. Wenn das element "Enabled" auf NDIS_OFFLOAD_SET_ON festgelegt ist, muss ein Protokolltreiber HeaderSize- auf die Größe des von ihr verwendeten Ethernet-Headers festlegen.

Bemerkungen

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

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.0 und höher.
Header- ndis/encapsulationconfig.h (include ndis.h)

Siehe auch

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_OFFLOAD_ENCAPSULATION