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

  • Artigo

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

A função MiniportInvalidateOffload invalida objetos de estado de chaminé TCP descarregados anteriormente.

Sintaxe

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN 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 para o NDIS quando ele chamou NdisMSetMiniportAttributes de sua Função MiniportInitializeEx .

[in] 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 o objeto de estado descarregado que está sendo invalidado.

Retornar valor

Nenhum

Comentários

A função MiniportInvalidateOffload armazena o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação de invalidação de forma assíncrona chamando NdisMInvalidateOffloadComplete.

A árvore passada para a função MiniportInvalidateOffload contém apenas NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estruturas. A árvore não contém nenhuma estrutura de estado de descarregamento. Ou seja, não existem estruturas desse tipo seguindo as estruturas NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na memória.

As estruturas NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na árvore indicam o objeto de estado a ser invalidado. Um membro não NULL *MiniportOffloadContext aponta para um local de memória que contém um valor PVOID que foi fornecido pelo destino de descarregamento quando o objeto de estado foi descarregado. Para obter mais informações, consulte Armazenando e referenciando o estado descarregado. Esse valor PVOID faz referência ao contexto de descarregamento de miniporto no qual o destino de descarregamento armazena o objeto de estado a ser invalidado.

Para obter informações sobre o tratamento de um destino de descarregamento de objetos de estado invalidados, consulte Tratamento de objetos de estado invalidados.

Eventualmente, a pilha de host encerrará o descarregamento do objeto de estado invalidado. No entanto, até esse momento, o destino de descarregamento possui o objeto de estado invalidado. O destino de descarregamento não deve liberar os recursos para o objeto de estado invalidado até que a pilha de host encerre o descarregamento desse objeto de estado. O destino de descarregamento não deve usar o objeto de estado invalidado ou nenhuma conexão TCP que dependa desse objeto de estado para enviar dados.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ndischimney.h (inclua Ndischimney.h)
IRQL Qualquer nível

Confira também

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes