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

Статья
08/07/2023

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

Структура 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, включая заголовок, в байтах.

Элемент Type структуры 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), указанный элементом Type элемента Header . NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуры, связанные с помощью указателей NextBlock , всегда находятся на одном уровне состояния разгрузки. Значение NextBlock, равное NULL, указывает на отсутствие дополнительной структуры следующего 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.

Значение DependentBlockList, равное NULL, указывает на отсутствие зависимой структуры 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 структурами.