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

Artigo
02/26/2024

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

O NDIS chama a função ProtocolInitiateOffloadComplete de um driver de protocolo ou de driver intermediário para concluir uma operação de descarregamento iniciada anteriormente pelo driver chamando a função NdisInitiateOffload .

Sintaxe

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parâmetros

[in] ProtocolBindingContext

Um identificador para uma área de contexto alocada pelo driver de protocolo. O driver mantém as informações de contexto por associação nessa área de contexto. O driver forneceu esse identificador para o NDIS quando o driver chamou a função NdisOpenAdapterEx .

[in] OffloadBlockList

Um ponteiro para uma estrutura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST que pode ser uma estrutura autônoma ou a raiz de uma lista vinculada dessas estruturas. Essas estruturas identificam o estado que foi descarregado ou que tentou ser descarregado.

Retornar valor

Nenhum

Comentários

Em resposta à chamada de um destino de descarregamento subjacente ou de um driver intermediário para a função NdisMInitiateOffloadComplete , o NDIS chama a função ProtocolInitiateOffloadComplete do protocolo sobreposto ou do driver intermediário.

Um driver intermediário deve propagar a conclusão da operação de descarregamento de inicialização para o driver acima dele chamando NdisMInitiateOffloadComplete. Para obter mais informações, consulte Propagando a conclusão de uma operação de State-Manipulation.

A partir da estrutura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST que foi passada para sua função ProtocolInitiateOffloadComplete , o driver intermediário constrói uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST .

Para obter mais informações, consulte Reutilizando uma estrutura de NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Ao chamar a função NdisMInitiateOffloadComplete , o driver intermediário passa um ponteiro (o parâmetro OffloadBlockList ) para essa estrutura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST recém-construída.