Partilhar via

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

  • Artigo

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

O NDIS chama a função ProtocolIndicateOffloadEvent de um driver de protocolo ou driver intermediário para postar uma indicação que foi iniciada por uma chamada de destino de descarregamento ou driver subjacente para o função de NdisTcpOffloadEventHandler.

Sintaxe

TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;

void TcpOffloadEventHandler(
  [in] IN PVOID OffloadContext,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

Parâmetros

[in] OffloadContext

Um ponteiro para o protocolo ou a estrutura de NDIS_OFFLOAD_HANDLE do driver intermediário para a conexão TCP na qual a indicação está sendo feita. O protocolo ou driver intermediário forneceu esse ponteiro como um parâmetro de entrada para a função NdisInitiateOffload ao descarregar a conexão.

[in] EventType

O evento que está sendo indicado como um dos seguintes valores de TCP_OFFLOAD_EVENT_TYPE:

TcpIndicateDisconnect

Indica que o host remoto iniciou uma desconexão normal enviando um segmento FIN na conexão.

TcpIndicateRetrieve

Indica que o destino de descarregamento está solicitando a pilha de host para encerrar o descarregamento de uma conexão TCP.

TcpIndicateAbort

Indica que o host remoto iniciou uma desconexão anulativa enviando um segmento RST aceitável na conexão.

TcpIndicateSendBacklogChange

Indica uma alteração no tamanho de backlog de envio preferencial.

[in] EventSpecificInformation

Especifica informações adicionais sobre o evento que está sendo indicado da seguinte maneira:

TcpIndicateDisconnect

Não é significativo.

TcpIndicateRetrieve

Indica o motivo da solicitação de upload como um valor TCP_UPLOAD_REASON. Para obter mais informações, consulte NdisTcpOffloadEventHandler.

TcpIndicateAbort

Não é significativo.

TcpIndicateSendBacklogChange

Especifica o número ideal de bytes de dados de envio que a pilha de host deve ter pendente no destino de descarregamento para obter a melhor taxa de transferência de dados.

Valor de retorno

Nenhum

Observações

Para propagar a indicação para o driver ou pilha de host em excesso, o driver intermediário chama a função NdisTcpOffloadEventHandler. O driver intermediário passa os seguintes parâmetros para o
função de NdisTcpOffloadEventHandler:

  • O NdisOffloadHandle que o destino de descarregamento armazenado em seu contexto para a conexão TCP descarregada. Para obter mais informações, consulte referenciando o estado descarregado por meio de umde driver intermediário.
  • O EventType que o NDIS passou para a função ProtocolTcpOffloadEvent do driver intermediário.
  • O EventSpecificInformation que o NDIS passou para a função ProtocolTcpOffloadEvent do driver intermediário.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho ndischimney.h (inclua Ndischimney.h)

Consulte também

NdisTcpOffloadEventHandler