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

Artigo
08/07/2023

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

O NDIS chama a função MiniportTcpOffloadReceiveReturn para retornar a propriedade de NET_BUFFER_LIST e estruturas associadas a um destino de descarregamento.

Sintaxe

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

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 driver de miniporto forneceu esse identificador ao NDIS quando ele chamou NdisMSetMiniportAttributes de sua Função MiniportInitializeEx .

[in] NetBufferList

Um ponteiro para uma estrutura NET_BUFFER_LIST . Essa estrutura pode ser uma estrutura autônoma ou a primeira estrutura em uma lista vinculada de estruturas de NET_BUFFER_LIST. A lista vinculada pode conter estruturas de NET_BUFFER_LIST de uma ou mais chamadas para o Função NdisTcpOffloadReceiveHandler .

Retornar valor

A função MiniportTcpOffloadReceiveReturn sempre deve ter êxito. Portanto, a função MiniportTcpOffloadReceiveReturn sempre deve retornar NDIS_STATUS_SUCCESS.

Comentários

O NDIS chama a função MiniportTcpOffloadReceiveReturn para retornar a propriedade de estruturas NET_BUFFER_LIST e estruturas associadas que o destino de descarregamento passou em uma ou mais chamadas anteriores para o Função NdisTcpOffloadReceiveHandler .

A função MiniportTcpOffloadReceiveReturn pode preparar uma estrutura de NET_BUFFER_LIST retornada para uso em uma indicação de recebimento subsequente. Embora a função MiniportTcpOffloadReceiveReturn possa retornar as estruturas NET_BUFFER_LIST para um pool (por exemplo, ela pode chamar a função NdisFreeNetBufferList ), pode ser mais eficiente reutilizar as estruturas sem devolvê-las ao pool.

Observe que o driver de destino de descarregamento não deve descarregar e o adaptador de destino de descarregamento não deve ser fechado até que todos os buffers de recebimento indicados sejam retornados.