Compartilhar via


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

Confira também

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes