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

  • Статья

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

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

Синтаксис

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [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

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

Дерево, переданное функции MiniportInvalidateOffload , содержит только NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структуры. Дерево не содержит структур состояния разгрузки. То есть нет таких структур, следующих за NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структур в памяти.

Структуры NDIS_MINIPORT_OFFLOAD_BLOCK_LIST в дереве указывают на недействительный объект состояния. Член *MiniportOffloadContext , отличный от NULL, указывает на расположение памяти, содержащее значение PVOID, предоставленное целевым объектом разгрузки при разгрузке объекта состояния. Дополнительные сведения см. в разделе Хранение и ссылка на разгруженное состояние. Это значение PVOID ссылается на контекст разгрузки минипорта, в котором целевой объект разгрузки сохраняет объект состояния, который будет признан недействительным.

Сведения об обработке объектов недействительного состояния в целевом объекте разгрузки см. в разделе Обработка объектов недействительных состояний.

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

Требования

Требование Значение
Целевая платформа Windows
Header ndischimney.h (включая Ndischimney.h)
IRQL Любой уровень

См. также раздел

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes