W_INVALIDATE_OFFLOAD_HANDLER função de retorno de chamada (ndischimney.h)
[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 |