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

Artigo
08/07/2023

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

A função MiniportTerminateOffload encerra o descarregamento de um ou mais objetos de estado.

Sintaxe

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parâmetros

[in] MiniportAdapterContext

O identificador para uma área de contexto alocada de destino de descarregamento na qual o destino de descarregamento mantém informações de estado sobre essa instância do adaptador. O destino de descarregamento forneceu esse identificador ao NDIS quando ele chamou NdisMSetMiniportAttributes de sua Função MiniportInitializeEx .

[in, out] OffloadBlockList

Um ponteiro para um NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura, que pode ser a raiz de uma lista vinculada dessas estruturas. Essas estruturas identificam os objetos de estado descarregado que estão sendo encerrados.

Retornar valor

Nenhum

Comentários

A função MiniportTerminateOffload armazena o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação de encerramento de forma assíncrona chamando o Função NdisMTerminateOffloadComplete .

O ponteiro OffloadBlockList aponta para uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que pode ser uma estrutura autônoma ou a lista de blocos raiz em uma árvore de estado de descarregamento que contém várias estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Essas listas de blocos, bem como quaisquer estruturas de estado de descarregamento associadas a elas, são válidas até que o driver de miniporte chame a função NdisMTerminateOffloadComplete .

Cada estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST pode ser seguida imediatamente na memória por uma estrutura de estado delegado (XXX_OFFLOAD_STATE_DELEGATED). O destino de descarregamento copia valores de variáveis delegados nas estruturas de estado delegadas fornecidas pela pilha de host.

A pilha de host não solicitará o encerramento do descarregamento de uma conexão TCP até que ambas as seguintes condições sejam atendidas:

Todas as solicitações pendentes de invalidação, consulta e atualização relativas a essa conexão foram concluídas.
Todas as chamadas de recebimento e desconexão pendentes retornaram.