Função NdisOffloadTcpDisconnect (ndischimney.h)

Artigo
08/07/2023

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

Um protocolo ou driver intermediário chama a função NdisOffloadTcpDisconnect para fechar a metade de envio de uma conexão TCP descarregada. Além disso, se a desconexão a ser executada for uma desconexão normal, o protocolo ou o driver intermediário poderá fornecer dados de aplicativo que o destino de descarregamento subjacente deve transmitir na conexão TCP descarregada antes de enviar um segmento FIN.

Sintaxe

NDIS_STATUS NdisOffloadTcpDisconnect(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList,
  [in] IN ULONG                Flags
);

Parâmetros

[in] NdisOffloadHandle

Um ponteiro 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 única estrutura NET_BUFFER_LIST . Apenas uma estrutura NET_BUFFER está associada a essa estrutura NET_BUFFER_LIST.

[in] Flags

Como um dos seguintes valores, o tipo de desconexão a ser executado:

TCP_DISCONNECT_ABORTIVE_CLOSE

Especifica que o destino de descarregamento executa uma desconexão abortiva enviando um segmento RST.

TCP_DISCONNECT_GRACEFUL_CLOSE

Especifica que o destino de descarregamento executa uma desconexão normal enviando um segmento FIN.

Retornar valor

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

Comentários

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

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

Uma função 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 MiniportTcpOffloadDisconnect do driver intermediário.
Os mesmos Sinalizadores que o NDIS passou para a função MiniportTcpOffloadDisconnect do driver intermediário.

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