Função NdisOffloadTcpDisconnect (ndischimney.h)

Artigo
02/07/2025

[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 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 umde 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 anulativa enviando um segmento RST.

TCP_DISCONNECT_GRACEFUL_CLOSE

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

Valor de retorno

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

Observações

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 destino de descarregamento ou driver intermediário subjacente. 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 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 a função MiniportTcpOffloadDisconnect do driver intermediário.
O mesmo Flags que o NDIS passou para a função MiniportTcpOffloadDisconnect do driver intermediário.

Quando o destino de descarregamento ou driver subjacente conclui posteriormente a operação de desconexão chamando a função NdisTcpOffloadDisconnectComplete de, 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.