Função NdisOffloadTcpSend (ndischimney.h)

Artigo
08/07/2023

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

Um driver de protocolo ou driver intermediário chama a função NdisOffloadTcpSend para transmitir dados em uma conexão TCP descarregada.

Sintaxe

NDIS_STATUS NdisOffloadTcpSend(
  [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 um 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 NET_BUFFER_LIST. Cada estrutura NET_BUFFER_LIST na lista descreve uma lista de estruturas NET_BUFFER . Cada estrutura NET_BUFFER na lista aponta para uma cadeia de MDLs (listas de descritores de memória). Os MDLs contêm os dados a serem transmitidos. As NET_BUFFER_LIST e as estruturas associadas são bloqueadas para que permaneçam residentes na memória física. No entanto, eles não são mapeados para a memória do sistema.

Retornar valor

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

Comentários

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

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

Um NdisOffloadHandle que faz referência à estrutura 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 um driver intermediário.
O mesmo ponteiro PNET_BUFFER_LIST que o NDIS passou para a função MiniportTcpOffloadSend do driver intermediário.

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