W_UPDATE_OFFLOAD_HANDLER função de retorno de chamada (ndischimney.h)

Artigo
02/26/2024

[O recurso de descarregamento de chaminé TCP foi preterido e não deve ser usado.]

A função MiniportUpdateOffload atualiza objetos de estado de chaminé TCP descarregados anteriormente.

Sintaxe

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parâmetros

[in] MiniportAdapterContext

O identificador para uma área de contexto alocada por 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 ao NDIS quando ele chamou NdisMSetMiniportAttributes de sua Função MiniportInitializeEx .

[in] 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 atualizados. Somente variáveis armazenadas em cache são atualizadas.

Retornar valor

Nenhum

Comentários

Somente variáveis armazenadas em cache são atualizadas.

A função MiniportUpdateOffload armazena o identificador MiniportAdapterContext e o ponteiro OffloadBlockList e retorna. O destino de descarregamento sempre conclui a operação de atualização de forma assíncrona chamando o Função NdisMUpdateOffloadComplete . 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 uma á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 miniporte chame o Função NdisMUpdateOffloadComplete .

Antes que a função MiniportUpdateOffload retorne, o destino de descarregamento usa a árvore de estado de descarregamento passada para a função MiniportUpdateOffload para atualizar o estado descarregado:

O destino de descarregamento copia os valores de variáveis de qualquer estrutura de estado na árvore para os objetos de estado descarregado correspondentes. Somente variáveis CACHED são atualizadas.
A árvore pode indicar que os links de caminho para vizinho devem ser atualizados. Para obter mais informações, consulte Vinculando objetos de estado de caminho a um novo objeto de estado vizinho. Nesse caso, o destino de descarregamento deve atualizar sua representação interna do estado descarregado para refletir os links atualizados.