структура NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS (ndischimney.h)

Статья
08/07/2023

[Функция разгрузки tcp chimney является устаревшей и не должна использоваться.]

Структура NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS предоставляет сведения о разгрузке дымохода TCP в OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Синтаксис

typedef struct _NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS {
  NDIS_OBJECT_HEADER         Header;
  NDIS_OFFLOAD_ENCAPSULATION Encapsulation;
  ULONG                      TicksPerSecond;
  UCHAR                      TcpAckFrequency;
  UCHAR                      TcpDelayedAckTicks;
  UCHAR                      TcpMaximumRetransmissions;
  UCHAR                      TcpDoubtReachabilityRetransmissions;
  ULONG                      TcpSwsPreventionTicks;
  ULONG                      TcpDuplicateAckThreshold;
  ULONG                      TcpPushTicks;
  ULONG                      NceStaleTicks;
  ULONG                      CongestionAlgorithm;
} NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS, *PNDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS. Задайте для элемента Type структуры, указанной в заголовке, значение NDIS_OBJECT_TYPE_DEFAULT, для элемента Revision — NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS_ 1, а для элемента Size — значение sizeof(NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS).

Encapsulation

Обычного NDIS_OFFLOAD_ENCAPSULATION структура, содержащая параметры инкапсуляции для разгрузки tcp-дымохода.

TicksPerSecond

Значение ULONG, которое задает стек драйвера TCP/IP, чтобы указать, сколько тактов часов узла равно одной секунде. Значение по умолчанию — 1000 (то есть 1 тактов = 1 миллисекунда). Целевой объект разгрузки должен поддерживать этот элемент.

TcpAckFrequency

Значение UCHAR, заданное стеком драйверов TCP/IP для указания максимального числа сегментов, которые может получить целевой объект разгрузки до отправки целевого объекта ACK. Целевой объект разгрузки должен поддерживать этот элемент.

TcpDelayedAckTicks

Значение UCHAR, которое задает стек драйвера TCP/IP, чтобы указать, сколько тактов, начиная с получения сегмента, целевой объект разгрузки должен ожидать дополнительных сегментов получения, прежде чем целевой объект отправит ACK. Целевой объект разгрузки использует это значение для инициализации таймера отложенной атаки. Целевой объект разгрузки должен поддерживать этот элемент.

TcpMaximumRetransmissions

Значение UCHAR, заданное стеком драйвера TCP/IP для указания максимального количества раз, когда целевой объект разгрузки должен повторно передавать сегмент в TCP-подключении. Если счетчик повторной передачи для TCP-подключения превышает это ограничение, целевой объект разгрузки может вызватьФункция NdisTcpOffloadEventHandler с параметром EventTypeTcpIndicateRetrieve запрашивает завершение разгрузки подключения стеком драйверов TCP/IP. Целевой объект разгрузки должен поддерживать этот элемент.

TcpDoubtReachabilityRetransmissions

Значение UCHAR, заданное стеком драйвера TCP/IP для указания максимального количества раз, когда целевой объект разгрузки должен повторно передавать сегмент, прежде чем целевой объект указывает стеку драйверов TCP/IP, что доступность соседнего объекта вызывает сомнения. Дополнительные сведения об этом указании см. в разделе NdisMOffloadEventIndicate. Целевой объект разгрузки должен поддерживать этот элемент.

TcpSwsPreventionTicks

Значение ULONG, которое стек драйвера TCP/IP задает для указания количества тактов для таймеров отправки и получения целевого объекта разгрузки (SWS). Когда таймер отправки SWS истекает, целевой объект разгрузки отправляет частичный сегмент. Когда таймер получения SWS истекает, целевой объект разгрузки отправляет обновление окна. Целевой объект разгрузки должен поддерживать этот элемент.

TcpDuplicateAckThreshold

Значение ULONG, которое стек драйвера TCP/IP задает для указания количества повторяющихся подтверждений, которые должен получить целевой объект разгрузки, прежде чем целевой объект выполнит быструю повторную передачу. Целевой объект разгрузки должен поддерживать этот элемент.

TcpPushTicks

Значение ULONG, заданное стеком драйвера TCP/IP, чтобы указать количество тактов, которое целевой объект разгрузки должен ждать, прежде чем целевой объект завершит предварительно размещенный буфер приема. Этот интервал начинается сразу после того, как целевой объект разгрузки помещает первый байт в предварительно размещенный буфер приема. Целевой объект разгрузки использует это значение для инициализации таймера отправки. Целевой объект разгрузки должен поддерживать этот элемент.

NceStaleTicks

Значение ULONG, заданное стеком драйвера TCP/IP, чтобы указать количество тактов бездействия, из-за которых устаревает соседний объект состояния. Целевой объект разгрузки должен поддерживать этот элемент.

CongestionAlgorithm

Зарезервировано для последующего использования.

Если вы являетесь независимым поставщиком оборудования (IHV) и хотите реализовать алгоритмы управления перегрузкой, например составной TCP, обратитесь в корпорацию Майкрософт по адресу External TCP Offload Triage.

В NDIS 6.0 и более поздних версиях структура NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS указывает текущие или запрашиваемые параметры, которые адаптер мини-порта предоставляет для разгрузки tcp-дымохода.

Чтобы указать различные параметры параметров разгрузки, NDIS и драйверы overlying предоставляют структуру NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS при установке OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Чтобы получить текущие параметры различных параметров разгрузки, NDIS и избыточные драйверы запрашивают OID_TCP_CONNECTION_OFFLOAD_PARAMETERS. Драйвер мини-порта возвращает текущие параметры в структуре NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS.

Элемент инкапсуляции NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS определяет параметры инкапсуляции разгрузки tcp chimney для адаптера мини-порта. Дополнительные сведения см. в документации по разгрузке дымохода TCP NDIS 6.0.