функция обратного вызова W_UPDATE_OFFLOAD_HANDLER (ndischimney.h)
[Функция разгрузки дымохода 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 структуру, которая может быть корнем связанного списка таких структур. Эти структуры определяют загруженные объекты состояния, которые обновляются. Обновляются только кэшированные переменные.
Возвращаемое значение
Никакой
Замечания
Обновляются только кэшированные переменные.
Функция MiniportUpdateOffloadхранит дескриптор MiniportAdapterContext и указатель OffloadBlockList, а затем возвращает указатель. Целевой объект разгрузки всегда завершает операцию обновления асинхронно путем вызова функции NdisMUpdateOffloadComplete. Указатель offloadBlockList указывает на структуру NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, которая может быть автономной структурой или списком корневого блока в дереве состояния разгрузки, содержащей несколько структур NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Такие списки блокировок, а также любые разгрузки структур состояний, связанных с ними, допустимы до тех пор, пока драйвер минипорта не вызовет функции NdisMUpdateOffloadComplete.
Прежде чем функция MiniportUpdateOffload возвращается, целевой объект разгрузки использует дерево состояния разгрузки, переданное функции miniportUpdateOffload для обновления отключенного состояния:
- Целевой объект разгрузки копирует значения переменных из любых структур состояний в дереве в соответствующие отключенные объекты состояния. Обновляются только переменные CACHED.
- Дерево может указывать на то, что необходимо обновить ссылки на путь к соседству. Дополнительные сведения см. в разделе Связывание объектов состояния пути с новым объектом состояния соседа. В этом случае целевой объект разгрузки должен обновить внутреннее представление отключенного состояния, чтобы отразить обновленные ссылки.
Требования
Требование | Ценность |
---|---|
целевая платформа | Виндоус |
заголовка | ndischimney.h (включая Ndischimney.h) |
IRQL | Любой уровень |