функция обратного вызова W_TERMINATE_OFFLOAD_HANDLER (ndischimney.h)

Статья
02/26/2024

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

Функция MiniportTerminateOffload завершает разгрузку одного или нескольких объектов состояния.

Синтаксис

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор выделенной области контекста целевого объекта разгрузки, в которой целевой объект разгрузки хранит сведения о состоянии этого экземпляра адаптера. Целевой объект разгрузки предоставил этот дескриптор NDIS при вызове NdisMSetMiniportAttributes из егоФункция MiniportInitializeEx.

[in, out] OffloadBlockList

Указатель на NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структуры, которая может быть корнем связанного списка таких структур. Эти структуры идентифицируют завершаемые объекты состояния разгрузки.

Возвращаемое значение

None

Remarks

Функция MiniportTerminateOffload сохраняет указатель OffloadBlockList , а затем возвращает значение . Целевой объект разгрузки всегда асинхронно завершает операцию завершения путем вызоваФункция NdisMTerminateOffloadComplete.

Указатель OffloadBlockList указывает на NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структуру, которая может быть либо автономной структурой, либо корневым списком блоков в дереве состояния разгрузки , содержающем несколько NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структур. Такие списки блокировок, а также все связанные с ними структуры состояния разгрузки действительны до тех пор, пока драйвер мини-порта не вызовет функцию NdisMTerminateOffloadComplete .

За каждой NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структурой в памяти сразу же следует делегированная структура состояния (XXX_OFFLOAD_STATE_DELEGATED). Целевой объект разгрузки копирует значения делегированных переменных в делегированные структуры состояния, предоставляемые стеком узлов.

Стек узлов не будет запрашивать завершение разгрузки TCP-подключения, пока не будут выполнены оба следующих условия:

Все незавершенные запросы на отмену, запросы и обновления, относящиеся к этому подключению, завершены.
Все невыполненные вызовы приема и отключения возвращены.