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.
Retornar valor
Nenhum
Comentários
A função MiniportQueryOffload pode consultar qualquer estado de chaminé TCP que tenha sido 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 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 um dos seguintes valores NDIS_STATUS no membro Status 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 |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | ndischimney.h (inclua Ndischimney.h) |
| IRQL | Qualquer nível |