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

Статья
02/07/2025

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

Структура NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST.

Синтаксис

typedef struct _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;
  IN _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[3];
  IN OUT PNDIS_OFFLOAD_HANDLE          OffloadHandle;
  IN PVOID                             ProtocolReserved[2];
  IN PVOID                             MiniportReserved[2];
  IN PVOID                             ImReserved[2];
  IN PVOID                             Scratch[2];
  IN PVOID                             SourceHandle;
  IN NDIS_PORT_NUMBER                  PortNumber;
  IN OUT PNET_BUFFER_LIST              NetBufferListChain;
} NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, *PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST;

Члены

Header

Заголовок структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Заголовок форматируется как структура NDIS_OBJECT_HEADER. Структура NDIS_OBJECT_HEADER содержит номер редакции структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, тип состояния разгрузки, который сразу же следует NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуре в памяти, а также размер структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, включая заголовок, в байтах.

Элемент типа структуры NDIS_OBJECT_HEADER указывает тип состояния разгрузки и, по сути, конкретную структуру состояния разгрузки (или структуры), которая сразу же следует NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуре в памяти.

Поддерживаются следующие OFFLOAD_STATE_TYPE значения:

NeighborOffloadConstState

Указывает состояние константы соседа. Это состояние отформатировано как структура NEIGHBOR_OFFLOAD_STATE_CONST.

NeighborOffloadCachedState

Указывает кэшированное состояние соседа. Это состояние отформатировано как структура NEIGHBOR_OFFLOAD_STATE_CACHED.

NeighborOffloadDelegatedState

Указывает делегированное состояние соседа. Это состояние отформатировано как структура NEIGHBOR_OFFLOAD_STATE_DELEGATED.

NeighborOffloadState

Указывает все соседнее состояние, включая константу, кэшированное и делегированное состояние соседа. Это состояние форматируется как структура NEIGHBOR_OFFLOAD_STATE_CONST, за которой следует NEIGHBOR_OFFLOAD_STATE_CACHED структура, а затем NEIGHBOR_OFFLOAD_STATE_DELEGATED структура.

Ip4OffloadConstState

Указывает состояние постоянного пути (IPv4). Это состояние отформатировано как PATH_OFFLOAD_STATE_CONST структура.

Ip4OffloadCachedState

Указывает состояние кэшированного пути (IPv4). Это состояние отформатировано как структура PATH_OFFLOAD_STATE_CACHED.

Ip4OffloadDelegatedState

Указывает состояние делегированного пути (IPv4). Это состояние отформатировано как PATH_OFFLOAD_STATE_DELEGATED структура. В настоящее время нет делегированного состояния пути. Структура PATH_OFFLOAD_STATE_DELEGATED не содержит переменных.

Ip4OffloadState

Указывает все состояние пути (IPv4), включая константу, кэшированное и делегированное состояние пути. Это состояние форматируется как структура PATH_OFFLOAD_STATE_CONST, за которой следует PATH_OFFLOAD_STATE_CACHED структура, за которой следует PATH_OFFLOAD_STATE_DELEGATED структура.

Ip6OffloadConstState

Указывает состояние постоянного пути (IPv6). Это состояние отформатировано как структура PATH_OFFLOAD_STATE_CONST.

Ip6OffloadCachedState

Указывает состояние кэшированного пути (IPv6). Это состояние отформатировано как структура PATH_OFFLOAD_STATE_CACHED.

Ip6OffloadDelegatedState

Указывает состояние делегированного пути (IPv6). Это состояние форматируется как структура PATH_OFFLOAD_STATE_DELEGATED. В настоящее время нет делегированного состояния пути. Структура PATH_OFFLOAD_STATE_DELEGATED не содержит переменных.

Ip6OffloadState

Указывает все состояние пути (IPv6), включая константу, кэшированное и делегированное состояние пути. Это состояние форматируется как структура PATH_OFFLOAD_STATE_CONST, за которой следует PATH_OFFLOAD_STATE_CACHED структура, за которой следует PATH_OFFLOAD_STATE_DELEGATED структура.

TcpOffloadConstState

Указывает постоянное состояние TCP. Это состояние отформатировано как структура TCP_OFFLOAD_STATE_CONST.

TcpOffloadCachedState

Указывает кэшированное состояние TCP. Это состояние отформатировано как TCP_OFFLOAD_STATE_CACHED структура.

TcpOffloadDelegatedState

Указывает делегированное состояние TCP. Это состояние отформатировано как структура TCP_OFFLOAD_STATE_DELEGATED.

TcpOffloadResourceState

Скрытный. Это OFFLOAD_STATE_TYPE значение, а также структура TCP_OFFLOAD_RESOURCE_STATE в настоящее время не используется.

TcpOffloadState

Указывает все состояние TCP, включая константу, кэшированное и делегированное состояние TCP. Это состояние форматируется как TCP_OFFLOAD_STATE_CONST структура, за которой следует TCP_OFFLOAD_STATE_CACHED структура, а затем TCP_OFFLOAD_STATE_DELEGATED структура.

FilterReservedOffloadState

Зарезервировано для драйверов фильтров.

NextBlock

Указатель на следующую NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуру на уровне состояния разгрузки (сосед, путь или TCP), указанный элементом типа элемента заголовка. NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуры, связанные с NextBlock, указатели всегда находятся на одном уровне состояния разгрузки. Значение NextBlockNULL указывает на отсутствие дополнительной NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуры на этом уровне.

_NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST

DependentBlockList

Указатель на структуру NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, которая находится на зависимом слое состояния разгрузки (более высокий уровень в дереве состояния разгрузки).

Для разгрузки дымохода TCP:

Элемент DependentBlockList элемента структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST на соседнем слое может указывать только на структуру NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST на уровне пути. Элемент DependentBlockList элемента структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST на уровне пути может указывать только на структуру NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST на уровне TCP. Элемент DependentBlockList структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST на уровне TCP всегда NULL.

Значение DependentBlockListNULL указывает на отсутствие зависимой структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST.

Status

Состояние завершения инициируемой разгрузки, разгрузки запроса, обновления разгрузки, отмены загрузки или завершения операции разгрузки, выполняемой целевой целью разгрузки, связанной с состоянием, связанным или на который ссылается структура NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. В зависимости от операции NDIS записывает одно из следующих NDIS_STATUS значений в элемент Status:

NDIS_STATUS_SUCCESS

Запуск разгрузки: базовый целевой объект разгрузки успешно выгрузил состояние, связанное со структурой NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST и состоянием, связанным со всеми немедленно зависимыми PROTOCOL_MINIPORT_OFFLOAD_BLOCK_LIST структурами.

Запрос, обновление, недопустимое или завершение разгрузки: целевой объект разгрузки успешно выполнил операцию по состоянию, связанному с или на который ссылается структура NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

Инициирование разгрузки: базовый целевой объект разгрузки успешно выгрузил состояние, связанное с структурой NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, но не удалось выгрузить состояние, связанное с одним или несколькими немедленно зависимыми NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структурами.