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

[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 de 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 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 o 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 que a pilha de host encerre o descarregamento de uma conexão TCP.

TcpIndicateAbort

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

TcpIndicateSendBacklogChange

Indica uma alteração no tamanho preferencial da lista de pendências de envio.

[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.

Retornar valor

Nenhum

Comentários

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

• O NdisOffloadHandle que o destino de descarregamento armazenou em seu contexto para a conexão TCP descarregada. Para obter mais informações, consulte Referenciando o estado descarregado por meio de um 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

Confira também

NdisTcpOffloadEventHandler