функция обратного вызова TCP_OFFLOAD_EVENT_HANDLER (ndischimney.h)
[Функция разгрузки tcp chimney является устаревшей и не должна использоваться.]
NDIS вызывает функцию ProtocolIndicateOffloadEvent драйвера протокола или промежуточного драйвера для отправки указания, что было инициировано вызовом базового драйвера или целевого объекта разгрузки дляФункция NdisTcpOffloadEventHandler.
Синтаксис
TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;
void TcpOffloadEventHandler(
[in] IN PVOID OffloadContext,
[in] IN ULONG EventType,
[in] IN ULONG EventSpecificInformation
)
{...}
Параметры
[in] OffloadContext
Указатель на структуру NDIS_OFFLOAD_HANDLE протокола или промежуточного драйвера для TCP-подключения, по которому производится указание. Протокол или промежуточный драйвер предоставил этот указатель в качестве входного параметра для функции NdisInitiateOffload при разгрузке подключения.
[in] EventType
Событие, указываемое как одно из следующих TCP_OFFLOAD_EVENT_TYPE значений:
TcpIndicateDisconnect
Указывает, что удаленный узел инициировал корректное отключение, отправив сегмент FIN для подключения.
TcpIndicateRetrieve
Указывает, что целевой объект разгрузки запрашивает стек узлов для прекращения разгрузки TCP-подключения.
TcpIndicateAbort
Указывает, что удаленный узел инициировал прерывание отключения, отправив приемлемый сегмент RST для подключения.
TcpIndicateSendBacklogChange
Указывает изменение предпочтительного размера невыполненной работы по отправке.
[in] EventSpecificInformation
Указывает дополнительные сведения о событии, указываемом следующим образом:
TcpIndicateDisconnect
Не имеет смысла.
TcpIndicateRetrieve
Указывает причину запроса на отправку в виде значения TCP_UPLOAD_REASON. Дополнительные сведения см. в разделе NdisTcpOffloadEventHandler.
TcpIndicateAbort
Не имеет смысла.
TcpIndicateSendBacklogChange
Указывает оптимальное количество байтов отправляемых данных, которое стек узлов должен иметь невыполненным в целевом объекте разгрузки для достижения наилучшей пропускной способности данных.
Возвращаемое значение
None
Remarks
Чтобы распространить указание на драйвер или стек узла, промежуточный драйвер вызывает функцию NdisTcpOffloadEventHandler . Промежуточный драйвер передает следующие параметры в
Функция NdisTcpOffloadEventHandler:
- NdisOffloadHandle, который целевой объект разгрузки хранится в контексте для разгрузки TCP-подключения. Дополнительные сведения см. в разделе Ссылка на состояние разгрузки через промежуточный драйвер.
- EventType, переданный NDIS функции ProtocolTcpOffloadEvent промежуточного драйвера.
- Объект EventSpecificInformation, переданный NDIS в функцию ProtocolTcpOffloadEvent промежуточного драйвера.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | ndischimney.h (включая Ndischimney.h) |