Поделиться через


функция обратного вызова 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 структуру, которая может быть корнем связанного списка таких структур. Эти структуры определяют отключенный объект состояния, который является недействительным.

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

Никакой

Замечания

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

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

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

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

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

Требования

Требование Ценность
целевая платформа Виндоус
заголовка ndischimney.h (включая Ndischimney.h)
IRQL Любой уровень

См. также

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes