Поделиться через

функция обратного вызова TCP_OFFLOAD_EVENT_HANDLER (ndischimney.h)

  • Статья

[Функция разгрузки дымохода TCP не рекомендуется и не должна использоваться.]

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

Указывает оптимальное количество байтов данных отправки, которые стек узлов должен иметь выдающийся в целевом объекте разгрузки для достижения оптимальной пропускной способности данных.

Возвращаемое значение

Никакой

Замечания

Чтобы распространить указание на избыточный драйвер или стек узлов, промежуточный драйвер вызывает функцию NdisTcpOffloadEventHandler. Промежуточный драйвер передает следующие параметры в
функция NdisTcpOffloadEventHandler:

  • NdisOffloadHandle, что целевой объект разгрузки, хранящийся в его контексте для отключенного TCP-подключения. Дополнительные сведения см. в разделе ссылки на отключенное состояние через промежуточный драйвер.
  • EventType, передаваемой NDIS в функцию промежуточного драйвера ProtocolTcpOffloadEvent.
  • EventSpecificInformation, передаваемой NDIS в функцию драйвера ProtocolTcpOffloadEvent.

Требования

Требование Ценность
целевая платформа Виндоус
заголовка ndischimney.h (включая Ndischimney.h)

См. также

NdisTcpOffloadEventHandler