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

Confira também

MiniportInitializeEx

NdisMSetMiniportAttributes