Função NdisOffloadTcpForward (ndischimney.h)

Artigo
02/07/2025

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

Um driver de protocolo ou um driver intermediário chama a função NdisOffloadTcpForward para encaminhar segmentos TCP recebidos não reconhecidos para um destino de descarregamento ou driver subjacente.

Sintaxe

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Parâmetros

[in] NdisOffloadHandle

Um identificador para uma estrutura NDIS_OFFLOAD_HANDLE no contexto do chamador para a conexão TCP descarregada. Para obter mais informações, consulte referenciando o estado descarregado por meio de umde driver intermediário.

[in] NetBufferList

Um ponteiro para uma estrutura NET_BUFFER_LIST. Essa estrutura pode ser uma estrutura autônoma ou a primeira estrutura em uma lista vinculada de estruturas de NET_BUFFER_LIST. Cada estrutura NET_BUFFER_LIST na lista descreve uma estrutura NET_BUFFER. Cada estrutura NET_BUFFER aponta para uma cadeia de MDLs (listas de descritores de memória). Os MDLs associados a uma estrutura NET_BUFFER contêm um e apenas um segmento TCP que está sendo encaminhado para o destino de descarregamento. O primeiro byte do primeiro MDL é o primeiro byte do cabeçalho TCP. Os NET_BUFFER_LIST e as estruturas associadas são bloqueados para que permaneçam residentes na memória física. No entanto, eles não são mapeados na memória do sistema.

Valor de retorno

A função NdisOffloadTcpForward sempre retorna NDIS_STATUS_PENDING. A operação de encaminhamento é sempre concluída de forma assíncrona.

Observações

Em resposta a uma chamada para sua função MiniportTcpOffloadForward, um driver intermediário chama a função NdisOffloadTcpForward para propagar a operação de encaminhamento para o driver subjacente ou o destino de descarregamento. Para obter mais informações, consulte Propagando operações de E/S.

Para a função NdisOffloadTcpForward, o driver intermediário passa o seguinte:

Uma função NdisOffloadHandle que faz referência à estrutura de NDIS_OFFLOAD_HANDLE armazenada no contexto do driver intermediário para a conexão TCP descarregada. Para obter mais informações, consulte referenciando o estado descarregado por meio de umde driver intermediário.
O mesmo ponteiro PNET_BUFFER_LIST que o NDIS passou para o driver intermediário função MiniportTcpOffloadForward.

Quando o destino de descarregamento ou driver subjacente conclui posteriormente a operação de encaminhamento chamando a função NdisTcpOffloadForwardComplete, o NDIS chama a função ProtocolOffloadForwardComplete do driver intermediário. Em seguida, o driver intermediário chama a função NdisTcpOffloadForwardComplete para propagar a conclusão da operação de encaminhamento.