W_TERMINATE_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 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 para o 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 descarregados que estão sendo encerrados.
Valor de retorno
Nenhum
Observações
A função MiniportTerminateOffload armazena o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação de término de forma assíncrona chamando o função de 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 um de á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 miniporto chame a função NdisMTerminateOffloadComplete.
Cada estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST pode ser seguida imediatamente na memória por uma estrutura de estado delegada (_OFFLOAD_STATE_DELEGATED XXX). 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 referentes a essa conexão foram concluídas.
- Todas as chamadas pendentes de recebimento e desconexão foram retornadas.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | ndischimney.h (inclua Ndischimney.h) |
| IRQL | Qualquer nível |