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

Статья
02/29/2024

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

Функция MiniportUpdateOffload обновляет ранее разгруженные объекты состояния дымохода TCP.

Синтаксис

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Параметры

[in] MiniportAdapterContext

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

[in] OffloadBlockList

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

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

None

Remarks

Обновляются только кэшированные переменные.

Функция MiniportUpdateOffload сохраняет дескриптор MiniportAdapterContext и указатель OffloadBlockList , а затем возвращает значение . Целевой объект разгрузки всегда асинхронно завершает операцию обновления путем вызоваФункция NdisMUpdateOffloadComplete. Указатель OffloadBlockList указывает на структуру NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, которая может быть автономной структурой или корневым списком блоков в дереве состояния разгрузки , содержающем несколько структур NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Такие списки блокировок, а также все связанные с ними структуры состояния разгрузки действительны до тех пор, пока драйвер мини-порта не вызоветФункция NdisMUpdateOffloadComplete.

Перед возвратом функции MiniportUpdateOffload целевой объект разгрузки использует дерево состояния разгрузки, переданное функции MiniportUpdateOffload , для обновления состояния разгрузки:

Целевой объект разгрузки копирует значения переменных из любых структур состояний в дереве в соответствующие объекты разгрузки состояния. Обновляются только переменные CACHED.
Дерево может указывать на то, что необходимо обновить ссылки пути к соседям. Дополнительные сведения см. в разделе Связывание объектов состояния пути с объектом нового соседнего состояния. В этом случае целевой объект разгрузки должен обновить внутреннее представление состояния разгрузки, чтобы отразить обновленные ссылки.