NDIS_TCP_CONNECTION_OFFLOAD estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_TCP_CONNECTION_OFFLOAD fornece informações de descarregamento de conexão para as configurações atuais e para recursos com suporte.

Sintaxe

typedef struct _NDIS_TCP_CONNECTION_OFFLOAD {
  NDIS_OBJECT_HEADER Header;
  ULONG              Encapsulation;
  ULONG              SupportIPv4 : 2;
  ULONG              SupportIPv6 : 2;
  ULONG              SupportIPv6ExtensionHeaders : 2;
  ULONG              SupportSack : 2;
  ULONG              CongestionAlgorithm : 4;
  ULONG              TcpConnectionOffloadCapacity;
  ULONG              Flags;
} NDIS_TCP_CONNECTION_OFFLOAD, *PNDIS_TCP_CONNECTION_OFFLOAD;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura de NDIS_TCP_CONNECTION_OFFLOAD. Defina o Type membro da estrutura que header especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão de para NDIS_TCP_CONNECTION_OFFLOAD_REVISION_1e o membro tamanho para NDIS_SIZEOF_TCP_CONNECTION_OFFLOAD_REVISION_1.

Encapsulation

Configurações de encapsulamento para descarregamento de chaminé TCP. Para obter mais informações sobre esse membro, consulte a seção Comentários a seguir.

SupportIPv4

Um valor ULONG que um destino de descarregamento define para indicar que ele dá suporte a IPv4. A pilha do driver TCP/IP define esse membro para habilitar o IPv4.

SupportIPv6

Um valor ULONG que um destino de descarregamento define para indicar que ele dá suporte a IPv6. A pilha do driver TCP/IP define esse membro para habilitar o IPv6. Observe que um destino de descarregamento pode dar suporte a IPv4 e IPv6.

SupportIPv6ExtensionHeaders

Um valor ULONG que um destino de descarregamento define para indicar que ele dá suporte a cabeçalhos de extensão IPv6 (ou seja, roteamento, fragmentação/remontagem, autenticação, encapsulamento, processamento de salto por salto e opções de destino). A pilha do driver TCP/IP define esse membro para habilitar cabeçalhos de extensão IPv6.

SupportSack

Um valor ULONG que um destino de descarregamento define para indicar que ele dá suporte a SACKs (confirmações seletivas de TCP) para operações de transmissão e recebimento. A pilha de driver TCP/IP define esse membro para habilitar SACKs para operações de transmissão e recebimento.

Se um destino de descarregamento definir o membro supportSack, o destino deverá ser capaz de gerar e consumir segmentos SACK. Se um destino de descarregamento não der suporte à opção SACK, o destino deverá ser capaz de ignorar a opção SACK e processar o restante do segmento TCP normalmente.

CongestionAlgorithm

Reservado para uso futuro.

Se você for um IHV (fornecedor de hardware independente) e quiser implementar algoritmos de controle de congestionamento não padrão, por exemplo, TCP Composto, entre em contato com a Microsoft Triagem de Descarregamento TCP Externo.

TcpConnectionOffloadCapacity

Um valor ULONG que um destino de descarregamento define para indicar o número máximo de conexões TCP descarregadas compatíveis. Esse número inclui conexões IPv4 e IPv6.

Flags

Reservado.

Observações

A estrutura NDIS_TCP_CONNECTION_OFFLOAD especifica os serviços atuais ou compatíveis que um adaptador de miniporto fornece para descarregamento de chaminé TCP.

A estrutura de NDIS_TCP_CONNECTION_OFFLOAD é usada no estrutura NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES, estrutura NDIS_BIND_PARAMETERS, OID_TCP_CONNECTION_OFFLOAD_CURRENT_CONFIG OID, OID_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES OID, NDIS_STATUS_OFFLOAD_RESUME indicação de status e NDIS_STATUS_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES indicação de status. (Para obter informações sobre NDIS_STATUS_OFFLOAD_RESUME, consulte documentação de descarregamento de chaminés NDIS 6.0 TCP.)

Os drivers de miniporto não recebem as consultas OID. O NDIS usa as informações que o driver de miniporto fornece em atributos e indicações de status para fornecer respostas a consultas OID e fornecer parâmetros de associação.

O NDIS fornece uma estrutura NDIS_TCP_CONNECTION_OFFLOAD em resposta a uma consulta de OID_TCP_CONNECTION_OFFLOAD_CURRENT_CONFIG ou OID_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES. Em resposta a uma consulta OID_TCP_CONNECTION_OFFLOAD_CURRENT_CONFIG, a estrutura NDIS_TCP_CONNECTION_OFFLOAD especifica as configurações atuais do destino de descarregamento. Em resposta a uma consulta OID_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES, a estrutura NDIS_TCP_CONNECTION_OFFLOAD especifica os recursos de hardware do destino de descarregamento para descarregar conexões TCP do transporte TCP/IP.

O membro de Encapsulamento do NDIS_TCP_CONNECTION_OFFLOAD define as configurações de encapsulamento de descarregamento de chaminé TCP para o adaptador de miniporto.

Para um OID_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES solicitação de consulta, o NDIS fornece um único sinalizador que indica os recursos de encapsulamento de hardware, no membro de Encapsulamento.

Para um OID_TCP_CONNECTION_OFFLOAD_CURRENT_CONFIG solicitação de consulta, o NDIS fornece um OR bit a bit dos sinalizadores de encapsulamento, o que indica as configurações de encapsulamento atuais.

Os seguintes sinalizadores são definidos para o membro de Encapsulamento:

Importante Um driver de miniporto ou mux que seja capaz de chaminé deve definir o membro de Encapsulamento como NDIS_ENCAPSULATION_IEEE_802_3, NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED ou ambos. Caso contrário, a capacidade da chaminé não será reconhecida.

consultas de descarregamento de chaminé TCP

Quando um NDIS responde a uma consulta de OID_TCP_CONNECTION_OFFLOAD_HARDWARE_CAPABILITIES ou OID_TCP_CONNECTION_OFFLOAD_CURRENT_CONFIG para um destino de descarregamento, o NDIS fornece o SupportIp4, SupportIp6, SupportIp6ExtensionHeaderse supportISack membros da estrutura NDIS_TCP_CONNECTION_OFFLOAD. Esses membros podem ter um dos seguintes valores:

Um destino de descarregamento deve dar suporte a IPv4 ou IPv6 (ou ambos). Os destinos de descarregamento podem, opcionalmente, dar suporte a cabeçalhos de extensão IPv6.

Um destino de descarregamento não deve dar suporte a nenhuma opção IPv4. O destino de descarregamento deve encaminhar todos os datagramas de IP recebidos que contenham opções IPv4 para a pilha de driver TCP/IP. O destino de descarregamento indica esses datagramas de IP para a pilha do driver TCP/IP chamando NdisMIndicateReceiveNetBufferLists. A pilha de driver TCP/IP processa as opções IPv4 e retorna os datagramas para o destino de descarregamento função MiniportTcpOffloadForward. (Para obter informações sobre miniportTcpOffloadForward, consulte documentação de descarregamento de chaminés NDIS 6.0 TCP.)

O destino de descarregamento também deve fornecer um valor para o TcpConnectionOffloadCapacity membro do NDIS_TCP_CONNECTION_OFFLOAD. Esse valor deve ser o número máximo de conexões TCP descarregadas simultaneamente que o destino de descarregamento pode dar suporte.

Observe que um destino de descarregamento não pode indicar diretamente novos recursos de descarregamento. Em vez disso, o destino de descarregamento deve solicitar a pilha do driver TCP/IP para pausar e, em seguida, retomar os descarregamentos. Quando o adaptador de miniporto estiver pronto para retomar o descarregamento de conexões TCP, ele emitirá uma indicação de status NDIS_STATUS_OFFLOAD_RESUME para relatar os novos recursos de descarregamento de conexão. Para obter mais informações sobre NDIS_STATUS_OFFLOAD_RESUME, consulte documentação de descarregamento de chaminé NDIS 6.0 TCP.