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 se debe usar.]
NDIS llama a la función ProtocolIndicateOffloadEvent de un controlador de protocolo o intermedio para publicar una indicación iniciada por la llamada de un 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 realiza la indicación. El protocolo o controlador intermedio proporcionó este puntero como parámetro de entrada a la función NdisInitiateOffload al descargar la conexión.
[in] EventType
Evento que se indica como uno de los siguientes valores de 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 la pila de hosts para finalizar 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 tiene sentido.
TcpIndicateRetrieve
Indica el motivo de la solicitud de carga como un valor de TCP_UPLOAD_REASON. Para obtener más información, vea NdisTcpOffloadEventHandler.
TcpIndicateAbort
No tiene sentido.
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
None
Observaciones
Para propagar la indicación al controlador o a la pila de hosts excesivamente, el controlador intermedio llama a la función NdisTcpOffloadEventHandler . El controlador intermedio pasa los parámetros siguientes al
Función NdisTcpOffloadEventHandler :
- NdisOffloadHandle que el destino de descarga almacena en su contexto para la conexión TCP descargada. Para obtener más información, vea Hacer referencia al estado descargado a través de un controlador intermedio.
- EventType que NDIS pasó a la función ProtocolTcpOffloadEvent del controlador intermedio.
- EventSpecificInformation que NDIS pasó a la función ProtocolTcpOffloadEvent del controlador intermedio.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | ndischimney.h (incluya Ndischimney.h) |