structure NDIS_OFFLOAD_ENCAPSULATION (ndis/encapsulationconfig.h)

Article
02/06/2025

La structure NDIS_OFFLOAD_ENCAPSULATION spécifie les paramètres d’encapsulation lorsqu’elle est utilisée avec l’OID OID_OFFLOAD_ENCAPSULATION.

Syntaxe

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;

Membres

Header

Structure NDIS_OBJECT_HEADER pour la structure NDIS_OFFLOAD_ENCAPSULATION. Définissez le membre type de de la structure spécifiée par -en-tête sur NDIS_OBJECT_TYPE_OFFLOAD_ENCAPSULATION, le membre Revision sur NDIS_OFFLOAD_ENCAPSULATION_ REVISION _1 et le membre Size sur NDIS_SIZEOF_OFFLOAD_ENCAPSULATION_REVISION_1.

IPv4

Structure dans NDIS_OFFLOAD_ENCAPSULATION qui spécifie l’encapsulation IPv4 et qui contient les membres suivants :

IPv4.Enabled

Valeur ULONG qui active l’encapsulation IPv4. Un pilote de protocole définit activé sur NDIS_OFFLOAD_SET_ON s’il active les déchargements d’envoi volumineux IPv4 volumineux version 1 (LSOV1), le déchargement d’envoi volumineux version 2 (LSOV2) ou les déchargements de somme de contrôle. Si un pilote de protocole désactive tous les déchargements, il définit activé sur NDIS_OFFLOAD_SET_OFF. Sinon, le pilote de protocole définit activé sur NDIS_OFFLOAD_SET_NO_CHANGE.

IPv4.EncapsulationType

Type d’encapsulation IPv4. Si le membre activé n’est pas défini sur NDIS_OFFLOAD_SET_ON, ce membre est égal à zéro. Si le membre activé est défini sur NDIS_OFFLOAD_SET_ON, un pilote de protocole doit définir EncapsulationType sur l’une des valeurs suivantes :

Valeur	Signification
NDIS_ENCAPSULATION_IEEE_802_3	Spécifie l’encapsulation IEEE 802.3. Lorsque cette valeur est spécifiée, un pilote miniport doit également utiliser NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q ou NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB encapsulation le cas échéant. Pour plus d’informations, consultez la documentation de NDIS_OFFLOAD.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED	Spécifie l’encapsulation du contrôle de liaison logique (LLC) pour les protocoles routés, comme décrit dans RFC 1483. Cet indicateur est également utilisé pour indiquer l’encapsulation Ethernet LLC/SNAP.

IPv4.HeaderSize

Longueur d’en-tête Ethernet utilisée dans les paquets IPv4. Si le membre activé n’est pas défini sur NDIS_OFFLOAD_SET_ON, ce membre est égal à zéro. Si le membre activé est défini sur NDIS_OFFLOAD_SET_ON, un pilote de protocole doit définir HeaderSize sur la taille de l’en-tête Ethernet qu’il utilise.

IPv6

Structure dans NDIS_OFFLOAD_ENCAPSULATION qui spécifie l’encapsulation IPv6 et qui contient les membres suivants :

IPv6.Enabled

Valeur ULONG qui active l’encapsulation IPv6. Un pilote de protocole définit activé sur NDIS_OFFLOAD_SET_ON s’il active les déchargements IPv6 LSOV1, LSOV2 ou de somme de contrôle. Si un pilote de protocole désactive tous les déchargements, il définit activé sur NDIS_OFFLOAD_SET_OFF. Sinon, le pilote de protocole définit activé sur NDIS_OFFLOAD_SET_NO_CHANGE.

IPv6.EncapsulationType

Type d’encapsulation IPv6. Si le membre activé n’est pas défini sur NDIS_OFFLOAD_SET_ON, EncapsulationType est égal à zéro. Si le membre activé est défini sur NDIS_OFFLOAD_SET_ON, un pilote de protocole doit définir EncapsulationType sur l’une des valeurs suivantes :

Valeur	Signification
NDIS_ENCAPSULATION_IEEE_802_3	Spécifie l’encapsulation IEEE 802.3. Lorsque cette valeur est spécifiée, un pilote miniport doit également utiliser NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q ou NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB encapsulation le cas échéant. Pour plus d’informations, consultez la documentation de NDIS_OFFLOAD.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED	Spécifie l’encapsulation LLC pour les protocoles routés, comme décrit dans RFC 1483. Cet indicateur est également utilisé pour indiquer l’encapsulation Ethernet LLC/SNAP.

IPv6.HeaderSize

Longueur d’en-tête Ethernet utilisée dans les paquets IPv6. Si le membre activé n’est pas défini sur NDIS_OFFLOAD_SET_ON, ce membre est égal à zéro. Si le membre activé est défini sur NDIS_OFFLOAD_SET_ON, un pilote de protocole doit définir HeaderSize sur la taille de l’en-tête Ethernet qu’il utilise.

Remarques

La structure NDIS_OFFLOAD_ENCAPSULATION spécifie les paramètres d’encapsulation demandés qu’un adaptateur miniport doit utiliser pour les services de déchargement des tâches.

Dans un ensemble de OID_OFFLOAD_ENCAPSULATION, un pilote de protocole spécifie une structure NDIS_OFFLOAD_ENCAPSULATION dans le membre InformationBuffer de la structure NDIS_OID_REQUEST.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
d’en-tête	ndis/encapsulationconfig.h (include ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_OFFLOAD_ENCAPSULATION

Partager via