estrutura NDIS_OFFLOAD_PARAMETERS (ntddndis.h)

A estrutura NDIS_OFFLOAD_PARAMETERS especifica as configurações atuais de descarregamento de tarefa em resposta a uma solicitação de conjunto de OID de OID_TCP_OFFLOAD_PARAMETERS.

Sintaxe

typedef struct _NDIS_OFFLOAD_PARAMETERS {
  NDIS_OBJECT_HEADER                 Header;
  UCHAR                              IPv4Checksum;
  UCHAR                              TCPIPv4Checksum;
  UCHAR                              UDPIPv4Checksum;
  UCHAR                              TCPIPv6Checksum;
  UCHAR                              UDPIPv6Checksum;
  UCHAR                              LsoV1;
  UCHAR                              IPsecV1;
  UCHAR                              LsoV2IPv4;
  UCHAR                              LsoV2IPv6;
  UCHAR                              TcpConnectionIPv4;
  UCHAR                              TcpConnectionIPv6;
  ULONG                              Flags;
  UCHAR                              IPsecV2;
  UCHAR                              IPsecV2IPv4;
  struct {
    UCHAR RscIPv4;
    UCHAR RscIPv6;
  };
  struct {
    UCHAR EncapsulatedPacketTaskOffload;
    UCHAR EncapsulationTypes;
  };
  union {
    struct {
      USHORT VxlanUDPPortNumber;
    } VxlanParameters;
    ULONG Value;
  } EncapsulationProtocolParameters;
  _ENCAPSULATION_PROTOCOL_PARAMETERS _ENCAPSULATION_PROTOCOL_PARAMETERS;
  struct {
    UCHAR IPv4;
    UCHAR IPv6;
  } UdpSegmentation;
  struct {
    UCHAR Enabled;
  } UdpRsc;
} NDIS_OFFLOAD_PARAMETERS, *PNDIS_OFFLOAD_PARAMETERS;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura de NDIS_OFFLOAD_PARAMETERS . Defina o membro Type da estrutura especificada por Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT.

Para indicar a versão da estrutura NDIS_OFFLOAD_PARAMETERS , defina o membro Revision como um dos seguintes valores:

IPv4Checksum

A configuração de soma de verificação IPv4 do adaptador de miniport. Para obter mais informações, consulte a seção Comentários a seguir.

TCPIPv4Checksum

A configuração de soma de verificação IPv4 do adaptador de miniporto para pacotes TCP. Para obter mais informações, consulte a seção Comentários a seguir.

UDPIPv4Checksum

A configuração de soma de verificação IPv4 do adaptador de miniporto para pacotes UDP. Para obter mais informações, consulte a seção Comentários a seguir.

TCPIPv6Checksum

A configuração de soma de verificação IPv6 do adaptador de miniporto para pacotes TCP. Para obter mais informações, consulte a seção Comentários a seguir.

UDPIPv6Checksum

A configuração de soma de verificação IPv6 do adaptador de miniporto para pacotes UDP. Para obter mais informações, consulte a seção Comentários a seguir.

LsoV1

A configuração LSOV1 (versão de descarregamento de envio grande) do adaptador de miniporto. Essa configuração deve ser um dos seguintes valores:

IPsecV1

A configuração de descarregamento de IPsec (segurança de protocolo da Internet) do adaptador de miniport. Essa configuração deve ser um dos seguintes valores:

LsoV2IPv4

A configuração LSOV2 (descarregamento de envio grande) IPv4 versão 2 (LSOV2) do adaptador de miniport. Essa configuração deve ser um dos seguintes valores:

LsoV2IPv6

A configuração IPv6 LSOV2 do adaptador de miniport. Essas configurações são especificadas como um dos seguintes valores:

TcpConnectionIPv4

A configuração de descarregamento de conexão IPv4 do adaptador de miniport. Essas configurações são especificadas como um dos seguintes valores:

TcpConnectionIPv6

A configuração de descarregamento de conexão IPv6 do adaptador de miniport. Essas configurações são especificadas como um dos seguintes valores:

Flags

Um conjunto de sinalizadores que podem ser combinados com uma operação OR bit a bit. Defina esse membro como zero ou o seguinte valor:

IPsecV2

A configuração de descarregamento de IPsec (segurança de protocolo de Internet) versão 2 de um adaptador de miniporta que dá suporte a IPv6 e IPv4. Esse membro especifica a configuração para suporte a IPv6 e IPv4. Essa configuração deve ser um dos seguintes valores:

IPsecV2IPv4

A configuração de descarregamento de IPsec (segurança de protocolo de Internet) versão 2 de um adaptador de miniporta que dá suporte a IPv4 e não dá suporte a IPv6. Se o driver de miniporto der suporte a IPv6, o membro IPsecV2 especificará a configuração IPv4 e esse membro não será usado. Essa configuração deve ser um dos seguintes valores:

RscIPv4

Indica o estado de União do Segmento de Recebimento para IPv4.

RscIPv6

Indica o estado de União do Segmento de Recebimento para IPv6.

EncapsulatedPacketTaskOffload

Um driver de protocolo define EncapsulatedPacketTaskOffload da seguinte maneira:

Observação: para descarregamentos laterais de recebimento, como VMQ e RSS, há outros OIDs definidos que o driver de protocolo envia para habilitar e configurar os parâmetros de descarregamento (por exemplo, filas, hash e tabela de indireção). O membro EncapsulatedPacketTaskOffload é complementar a esses OIDs e instrui a NIC a também fazer esses descarregamentos para pacotes encapsulados.

EncapsulationTypes

Esse campo só é eficaz quando EncapsulatedPacketTaskOffload é definido como NDIS_OFFLOAD_SET_ON. Se o membro EncapsulatedPacketTaskOffload não estiver definido como NDIS_OFFLOAD_SET_ON, esse membro será zero. Um driver de protocolo deve definir EncapsulationTypes como o OR bit a bit dos sinalizadores correspondentes aos tipos de encapsulamento necessários. Ele pode selecionar sinalizadores do seguinte:

EncapsulationProtocolParameters

Uma união que descreve os parâmetros de encapsulamento para encapsulamento VXLAN.

Se o driver de miniporto anunciou VxlanUDPPortNumerConfigurable como TRUE, um driver de protocolo poderá definir EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber como um valor diferente de 0. O driver de miniporta deve usar esse número de porta para correspondência e geração de quadros VXLAN após o sucesso do OID e também anunciar o valor atualizado em seus recursos. Se o driver de protocolo passar um valor de 0, o driver de miniporta continuará a usar o número da porta inicializado do palavra-chave padronizado.

EncapsulationProtocolParameters.VxlanParameters

Uma estrutura que contém o VxlanUDPPortNumber.

EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber

O valor da porta de destino VXLAN. Esse valor é definido como o valor atribuído pela IANA de 4789 por padrão. Se o driver de miniporta der suporte a um número de porta configurável conforme anunciado na estrutura de NDIS_OFFLOAD , um driver de protocolo poderá emitir um OID OID_TCP_OFFLOAD_PARAMETERS para habilitar NDIS_ENCAPSULATION_TYPE_VXLAN com um valor diferente em VxlanUDPPortNumber. O driver de miniporta deve usar VxlanUDPPortNumber para determinar pacotes encapsulados de VXLAN para executar descarregamentos de recebimento.

EncapsulationProtocolParameters.Value

O valor da porta se EncapsulationTypes não estiver definido como NDIS_ENCAPSULATION_TYPE_VXLAN.

_ENCAPSULATION_PROTOCOL_PARAMETERS

O nome do tipo para EncapsulationProtocolParameters.

UdpSegmentation

Uma estrutura que descreve as configurações do USO (Descarregamento de Segmentação UDP) do adaptador de miniport.

UdpSegmentation.IPv4

A configuração USO (Descarregamento de Segmentação UDP) IPv4 do adaptador de miniporto. Essa configuração deve ser um dos seguintes valores:

UdpSegmentation.IPv6

A configuração uso (descarregamento de segmentação UDP) IPv6 do adaptador de miniport. Essa configuração deve ser um dos seguintes valores:

UdpRsc

Uma estrutura que descreve as configurações do URO (Descarregamento de Recebimento de Segmento de Recebimento) do adaptador de miniport.

UdpRsc.Enabled

A configuração URO do adaptador de miniport. Essa configuração deve ser um dos seguintes valores:

Comentários

Em resposta a uma solicitação OID_TCP_OFFLOAD_PARAMETERS conjunto de OID, um driver de miniporto usa as configurações na estrutura NDIS_OFFLOAD_PARAMETERS para definir a configuração atual do adaptador de miniport.

O NDIS mantém as configurações solicitadas no registro nas palavras-chave padronizadas de descarregamento. Quando o NDIS reinicia o adaptador de miniporto, o driver de miniporto lê as palavras-chave padronizadas de descarregamento e as usa para definir a configuração de descarregamento padrão da NIC.

Para acessar as configurações de descarregamento de soma de verificação, use os seguintes membros da estrutura NDIS_OFFLOAD_PARAMETERS :

IPv4Checksum

TCPIPv4Checksum

UDPIPv4Checksum

TCPIPv6Checksum

UDPIPv6Checksum

Os membros anteriores podem ter um dos seguintes valores:

NDIS_OFFLOAD_PARAMETERS_NO_CHANGE
O driver de miniporte não deve alterar a configuração atual.

NDIS_OFFLOAD_PARAMETERS_TX_RX_DISABLED
O recurso especificado pelo membro está desabilitado.

NDIS_OFFLOAD_PARAMETERS_TX_ENABLED_RX_DISABLED
O recurso especificado pelo membro está habilitado para transmissão e desabilitado para recebimento.

NDIS_OFFLOAD_PARAMETERS_RX_ENABLED_TX_DISABLED
O recurso especificado pelo membro está habilitado para recebimento e desabilitado para transmissão.

NDIS_OFFLOAD_PARAMETERS_TX_RX_ENABLED
O recurso especificado pelo membro está habilitado para transmissão e recebimento.

Requisitos

Confira também

NDIS_OBJECT_HEADER

OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES

OID_TCP_OFFLOAD_PARAMETERS