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

Статья
02/07/2025

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

Структура 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. Задайте элемент типа структуры, заголовка указывает NDIS_OBJECT_TYPE_DEFAULT, элемент редакцииNDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS_ 1, а член размера sizeof(NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS).

Encapsulation

An NDIS_OFFLOAD_ENCAPSULATION структура, содержащая параметры инкапсуляции для разгрузки дыма TCP.

TicksPerSecond

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

TcpAckFrequency

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

TcpDelayedAckTicks

Значение UCHAR, которое стек драйверов TCP/IP задает, чтобы указать, сколько галок, начиная с приема сегмента, целевой объект разгрузки должен ожидать дополнительных сегментов получения, прежде чем целевой объект отправляет ACK. Целевой объект разгрузки использует это значение для инициализации таймера отложенного 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 и драйверы, переопределяющие драйверы предоставляют структуру 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-трубы для мини-адаптера. Дополнительные сведения см. в документации по разгрузке NDIS 6.0 TCP.