TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER função de retorno de chamada (ndischimney.h)

Artigo
02/29/2024

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

O NDIS chama a função ProtocolTcpOffloadDisconnectComplete de um driver de protocolo ou de driver intermediário para concluir uma operação de desconexão iniciada anteriormente pelo driver chamando o Função NdisOffloadTcpDisconnect .

Sintaxe

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parâmetros

[in] ProtocolBindingContext

Um identificador para uma área de contexto alocada pelo driver de protocolo. O driver mantém as informações de contexto por associação nessa área de contexto. O driver forneceu esse identificador para o NDIS quando o driver chamou a função NdisOpenAdapterEx .

[in] NetBufferList

Quando não NULL, um ponteiro para uma única estrutura NET_BUFFER_LIST . O driver forneceu esse ponteiro como um parâmetro de entrada em uma chamada anterior para o Função NdisOffloadTcpDisconnect .

Retornar valor

Nenhum

Comentários

Em resposta à chamada de um driver subjacente ou destino de descarregamento para o Função NdisTcpOffloadDisconnectComplete , o NDIS chama a função ProtocolTcpOffloadDisconnectComplete do driver de protocolo subjacente ou intermediária.

Para propagar a conclusão da operação de desconexão para o driver sobreposto, o driver intermediário chama a função NdisOffloadTcpDisconnectComplete , passando o seguinte:

Um ProtocolBindingContext, que é um identificador que identifica exclusivamente o driver intermediário.
O mesmo ponteiro PNET_BUFFER_LIST que o NDIS passou para a função ProtocolTcpOffloadDisconnectComplete do driver intermediário.

Em resposta, o NDIS chama a função ProtocolTcpOffloadDisconnectComplete do driver sobreposto, passando uma alça ProtocolBindingContext e o ponteiro PNET_BUFFER_LIST passado pelo driver intermediário para a função NdisOffloadTcpDisconnectComplete .

Antes de retornar, a função ProtocolTcpOffloadDisconnectComplete deve desalocar a memória para qualquer contexto criado para a estrutura NET_BUFFER_LIST que foi passada para a função.

Observe que, se um driver intermediário exportar mais de uma interface para protocolos de sobreposição, ele deverá determinar qual protocolo deve receber a conclusão da desconexão. Para fazer essa determinação, o driver intermediário usa informações armazenadas no NET_BUFFER_LIST_CONTEXT estrutura, que está associada à estrutura NET_BUFFER_LIST.