TCP_OFFLOAD_EVENT_HANDLER función de devolución de llamada (ndischimney.h)
[La característica de descarga de chimenea TCP está en desuso y no debe usarse].
NDIS llama a la función de ProtocolIndicateOffload Event de un controlador de protocolo o de un controlador intermedio para publicar una indicación iniciada por la llamada del controlador subyacente o de descarga al destino función NdisTcpOffloadEventHandler.
Sintaxis
TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;
void TcpOffloadEventHandler(
[in] IN PVOID OffloadContext,
[in] IN ULONG EventType,
[in] IN ULONG EventSpecificInformation
)
{...}
Parámetros
[in] OffloadContext
Puntero al protocolo o a la estructura NDIS_OFFLOAD_HANDLE del controlador intermedio para la conexión TCP en la que se está realizando la indicación. El protocolo o controlador intermedio proporcionó este puntero como parámetro de entrada al NdisInitiateOffload función al descargar la conexión.
[in] EventType
El evento que se indica como uno de los siguientes valores TCP_OFFLOAD_EVENT_TYPE:
TcpIndicateDisconnect
Indica que el host remoto inició una desconexión correcta mediante el envío de un segmento FIN en la conexión.
TcpIndicateRetrieve
Indica que el destino de descarga solicita a la pila de hosts que finalice la descarga de una conexión TCP.
TcpIndicateAbort
Indica que el host remoto inició una desconexión anulativa mediante el envío de un segmento RST aceptable en la conexión.
TcpIndicateSendBacklogChange
Indica un cambio en el tamaño de trabajo pendiente de envío preferido.
[in] EventSpecificInformation
Especifica información adicional sobre el evento que se indica de la siguiente manera:
TcpIndicateDisconnect
No significativo.
TcpIndicateRetrieve
Indica el motivo de la solicitud de carga como un valor de TCP_UPLOAD_REASON. Para obtener más información, consulte NdisTcpOffloadEventHandler.
TcpIndicateAbort
No significativo.
TcpIndicateSendBacklogChange
Especifica el número óptimo de bytes de datos de envío que la pila de hosts debe tener pendiente en el destino de descarga para lograr el mejor rendimiento de datos.
Valor devuelto
Ninguno
Observaciones
Para propagar la indicación al controlador o a la pila host excesiva, el controlador intermedio llama a la función NdisTcpOffloadEventHandler. El controlador intermedio pasa los parámetros siguientes al
función NdisTcpOffloadEventHandler:
- El NdisOffloadHandle que el destino de descarga almacenado en su contexto para la conexión TCP descargada. Para obtener más información, consulte hacer referencia al estado descargado a través de un controlador intermedio.
- El EventType que NDIS pasó a la función ProtocolTcpOffloadEvent del controlador intermedio.
- El EventSpecificInformation que NDIS pasó a la función ProtocolTcpOffloadEvent del controlador intermedio.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Windows |
encabezado de | ndischimney.h (incluya Ndischimney.h) |