estrutura PATH_OFFLOAD_STATE_CONST (ndischimney.h)

Artigo
02/07/2025

[O recurso de descarregamento de chaminé TCP foi preterido e não deve ser usado.]

A estrutura PATH_OFFLOAD_STATE_CONST contém as variáveis constantes de um objeto de estado de caminho.

Sintaxe

typedef struct _PATH_OFFLOAD_STATE_CONST {
  OFFLOAD_STATE_HEADER Header;
  const UCHAR          *SourceAddress;
  const UCHAR          *DestinationAddress;
} PATH_OFFLOAD_STATE_CONST, *PPATH_OFFLOAD_STATE_CONST;

Membros

Header

Uma estrutura OFFLOAD_STATE_HEADER. O NDIS define o Length membro de Header para o tamanho, em bytes, da estrutura PATH_OFFLOAD_STATE_CONST. O membro RecognizedOptions do Header está reservado.

SourceAddress

Um ponteiro para o endereço IP de origem de uma conexão TCP. Se a conexão TCP for por IPv4, o endereço será um endereço IPv4 de 4 bytes. Se a conexão TCP for por IPv6, o endereço será um endereço IPv6 de 16 bytes. Os bytes de endereço de origem estão sempre em ordem de bytes de rede.

DestinationAddress

Um ponteiro para o endereço IP de destino de uma conexão TCP. Se a conexão TCP for por IPv4, o endereço será um endereço IPv4 de 4 bytes. Se a conexão TCP for por IPv6, o endereço será um endereço IPv6 de 16 bytes. Os bytes de endereço de destino estão sempre em ordem de bytes de rede.

Observações

O valor de cada variável de constante de caminho não é alterado durante a vida útil de uma conexão TCP. Nem a pilha de host nem o destino de descarregamento alteram os valores de uma variável de constante de caminho. Quando a pilha de host termina o descarregamento do objeto de estado de caminho, fazendo com que o NDIS chame o destino de descarregamento função miniportTerminateOffload, o destino de descarregamento não retorna o valor das variáveis constantes de caminho descarregado para a pilha de host.

Quando passada para um destino de descarregamento, uma estrutura de PATH_OFFLOAD_STATE_CONST é associada a um NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura, que contém um cabeçalho formatado como uma estrutura NDIS_OBJECT_HEADER. O membro Revisão da estrutura NDIS_OBJECT_HEADER, nesse caso, especifica o número de revisão da estrutura de PATH_OFFLOAD_STATE_CONST.