estrutura NDIS_OFFLOAD_ENCAPSULATION (ndis/encapsulationconfig.h)

  • Artigo

A estrutura NDIS_OFFLOAD_ENCAPSULATION especifica as configurações de encapsulamento quando é usada com o OID do OID_OFFLOAD_ENCAPSULATION .

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_OFFLOAD_ENCAPSULATION. Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_OFFLOAD_ENCAPSULATION, o membro Revision como NDIS_OFFLOAD_ENCAPSULATION_ REVISION _1 e o membro Size para NDIS_SIZEOF_OFFLOAD_ENCAPSULATION_REVISION_1.

IPv4

Uma estrutura dentro NDIS_OFFLOAD_ENCAPSULATION que especifica o encapsulamento IPv4 e que contém os seguintes membros:

IPv4.Enabled

Um valor ULONG que habilita o encapsulamento IPv4. Um driver de protocolo define Habilitado para NDIS_OFFLOAD_SET_ON se estiver habilitando O LSOV1 (descarregamento de envio grande) IPv4, LSOV2 (versão de descarregamento de envio grande 2) ou descarregamentos de soma de verificação. Se um driver de protocolo estiver desativando todos os descarregamentos, ele definirá Habilitado como NDIS_OFFLOAD_SET_OFF. Caso contrário, o driver de protocolo define Habilitado como NDIS_OFFLOAD_SET_NO_CHANGE.

IPv4.EncapsulationType

O tipo de encapsulamento IPv4. Se o membro Enabled não estiver definido como NDIS_OFFLOAD_SET_ON, esse membro será zero. Se o membro Enabled estiver definido como NDIS_OFFLOAD_SET_ON, um driver de protocolo deverá definir EncapsulationType como um dos seguintes:

Valor Significado
NDIS_ENCAPSULATION_IEEE_802_3
 Especifica o encapsulamento IEEE 802.3. Quando esse valor é especificado, um driver de miniporta também deve usar NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q ou encapsulamento NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB, quando aplicável. Confira a documentação do NDIS_OFFLOAD para obter mais informações.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
 Especifica o encapsulamento de LLC (controle de link lógico) para protocolos roteados, conforme descrito em RFC 1483. Esse sinalizador também é usado para indicar o encapsulamento Ethernet LLC/SNAP.

IPv4.HeaderSize

O comprimento do cabeçalho Ethernet usado em pacotes IPv4. Se o membro Enabled não estiver definido como NDIS_OFFLOAD_SET_ON, esse membro será zero. Se o membro Enabled estiver definido como NDIS_OFFLOAD_SET_ON, um driver de protocolo deverá definir HeaderSize como o tamanho do cabeçalho Ethernet que ele usa.

IPv6

Uma estrutura dentro de NDIS_OFFLOAD_ENCAPSULATION que especifica o encapsulamento IPv6 e que contém os seguintes membros:

IPv6.Enabled

Um valor ULONG que habilita o encapsulamento IPv6. Um driver de protocolo define Habilitado para NDIS_OFFLOAD_SET_ON se estiver habilitando descarregamentos IPv6 LSOV1, LSOV2 ou soma de verificação. Se um driver de protocolo estiver desativando todos os descarregamentos, ele definirá Habilitado como NDIS_OFFLOAD_SET_OFF. Caso contrário, o driver de protocolo define Habilitado como NDIS_OFFLOAD_SET_NO_CHANGE.

IPv6.EncapsulationType

O tipo de encapsulamento IPv6. Se o membro Enabled não estiver definido como NDIS_OFFLOAD_SET_ON, EncapsulationType será zero. Se o membro Enabled estiver definido como NDIS_OFFLOAD_SET_ON, um driver de protocolo deverá definir EncapsulationType como um dos seguintes:

Valor Significado
NDIS_ENCAPSULATION_IEEE_802_3
 Especifica o encapsulamento IEEE 802.3. Quando esse valor é especificado, um driver de miniporta também deve usar NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q ou encapsulamento NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB, quando aplicável. Confira a documentação do NDIS_OFFLOAD para obter mais informações.
NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
 Especifica o encapsulamento llc para protocolos roteados, conforme descrito em RFC 1483. Esse sinalizador também é usado para indicar o encapsulamento Ethernet LLC/SNAP.

IPv6.HeaderSize

O comprimento do cabeçalho Ethernet usado em pacotes IPv6. Se o membro Enabled não estiver definido como NDIS_OFFLOAD_SET_ON, esse membro será zero. Se o membro Enabled estiver definido como NDIS_OFFLOAD_SET_ON, um driver de protocolo deverá definir HeaderSize como o tamanho do cabeçalho Ethernet que ele usa.

Comentários

A estrutura NDIS_OFFLOAD_ENCAPSULATION especifica as configurações de encapsulamento solicitadas que um adaptador de miniporto deve usar para serviços de descarregamento de tarefas.

Em um conjunto de OID_OFFLOAD_ENCAPSULATION, um driver de protocolo especifica uma estrutura NDIS_OFFLOAD_ENCAPSULATION no membro InformationBuffer da estrutura NDIS_OID_REQUEST .

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Cabeçalho ndis/encapsulationconfig.h (inclua ndis.h)

Confira também

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_OFFLOAD_ENCAPSULATION