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.
Valor de retorno
Nenhum
Observações
A função MiniportInvalidateOffload armazena o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação invalidada de forma assíncrona chamando NdisMInvalidateOffloadComplete.
A árvore passada para a função MiniportInvalidateOffload contém apenas estruturas NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. A árvore não contém nenhuma estrutura de estado de descarregamento . Ou seja, não existem tais estruturas seguindo as estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na memória.
As estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na árvore indicam que o objeto de estado será invalidado. Um membro de *MiniportOffloadContext não NULL aponta para um local de memória que contém um valor PVOID fornecido pelo destino de descarregamento quando o objeto de estado foi descarregado. Para obter mais informações, consulte Armazenando e referenciandode 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 Treatment of Invalidated State Objects.
Eventualmente, a pilha de host encerrará o descarregamento do objeto de estado invalidado. No entanto, até esse momento, o destino de descarregamento é proprietário do 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 tenha terminado o descarregamento desse objeto de estado. O destino de descarregamento não deve usar o objeto de estado invalidado ou quaisquer conexões TCP que dependam desse objeto de estado para enviar dados.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | ndischimney.h (inclua Ndischimney.h) |
| IRQL | Qualquer nível |