функция обратного вызова W_TERMINATE_OFFLOAD_HANDLER (ndischimney.h)
[Функция разгрузки дымохода TCP не рекомендуется и не должна использоваться.]
Функция 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 структуру, которая может быть корнем связанного списка таких структур. Эти структуры определяют отключенные объекты состояния, которые завершаются.
Возвращаемое значение
Никакой
Замечания
Функция 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-подключения до тех пор, пока не будут выполнены оба следующих условия:
- Все невыполненные недопустимые запросы, запросы и обновления, относящиеся к этому подключению, завершены.
- Возвращены все невыполненные вызовы приема и отключения.
Требования
Требование | Ценность |
---|---|
целевая платформа | Виндоус |
заголовка | ndischimney.h (включая Ndischimney.h) |
IRQL | Любой уровень |