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

Статья
02/26/2024

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

Структура NDIS_MINIPORT_OFFLOAD_BLOCK_LIST является базовым стандартным блоком дерева состояния разгрузки дымохода TCP. Дерево состояния разгрузки может содержать одну или несколько NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структур.

Синтаксис

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  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_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

Члены

Header

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

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

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

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

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

Значение DependentBlockList , равное NULL , указывает на отсутствие зависимой структуры NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Status

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

NDIS_STATUS_SUCCESS

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

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

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

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