W_QUERY_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 MiniportQueryOffload consulta objetos de estado de chaminé TCP descarregados anteriormente.
Sintaxe
W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;
void WQueryOffloadHandler(
[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 o estado descarregado que está sendo consultado.
Valor de retorno
Nenhum
Observações
A função MiniportQueryOffload pode consultar qualquer estado de chaminé TCP descarregado para o destino de descarregamento.
A função MiniportQueryOffload armazena o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação de consulta de forma assíncrona chamando o função de NdisMQueryOffloadStateComplete. O ponteiro OffloadBlockList aponta para um NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura que pode ser uma estrutura autônoma ou o nó raiz em uma árvore de estado de descarregamento . A árvore de estado é válida até que o destino de descarregamento chame a função NdisMQueryOffloadStateComplete.
Depois de retornar da função MiniportQueryOffload, o driver de miniporto preenche a estrutura de estado de descarregamento associada a cada estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na árvore de estado apontada pelo ponteiro OffloadBlockList. Para cada uma dessas estruturas de estado de descarregamento, o driver de miniporto grava o valor atual de cada variável na estrutura.
Antes de chamar a função NdisMQueryOffloadStateComplete, o destino de descarregamento deve gravar qualquer um dos seguintes valores de NDIS_STATUS no Status membro de cada estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na árvore de estado:
-
NDIS_STATUS_SUCCESS
O destino de descarregamento consultou com êxito os objetos de estado.
-
NDIS_STATUS_FAILURE
A operação de consulta não foi bem-sucedida. A pilha de host encerrará os objetos de estado que não puderam ser consultados.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | ndischimney.h (inclua Ndischimney.h) |
| IRQL | Qualquer nível |