NDIS_OFFLOAD_ENCAPSULATION-Struktur (ndis/encapsulationconfig.h)
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 |
|---|---|
|
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. |
|
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 |
|---|---|
|
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. |
|
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) |