функция обратного вызова UPDATE_OFFLOAD_COMPLETE_HANDLER (ndischimney.h)
[Функция разгрузки дымохода TCP не рекомендуется и не должна использоваться.]
NDIS вызывает функцию драйвера протокола или промежуточного драйвера ProtocolUpdateOffloadComplete, чтобы завершить операцию разгрузки обновления, которую драйвер ранее инициировал путем вызова функции NdisUpdateOffload.
Синтаксис
UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;
void UpdateOffloadCompleteHandler(
[in] IN NDIS_HANDLE ProtocolBindingContext,
[in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}
Параметры
[in] ProtocolBindingContext
Дескриптор области контекста, выделенной драйвером протокола. Драйвер сохраняет сведения о контексте привязки в этой области контекста. Драйвер предоставил этот дескриптор NDIS, когда драйвер вызвал функцию NdisOpenAdapterEx
[in] OffloadBlockList
Указатель на объект NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуру, которая может быть автономной структурой или корнем связанного списка таких структур. Эти структуры определяют состояние, которое было обновлено или которое пыталось обновить.
Возвращаемое значение
Никакой
Замечания
В ответ на вызов целевого объекта разгрузки или промежуточного драйвера функция NDIsMUpdateOffloadComplete, NDIS вызывает функцию протокола или промежуточного драйвера ProtocolUpdateOffloadComplete.
Промежуточный драйвер должен распространить завершение операции разгрузки обновления на драйвер над ним, вызвав NdisMUpdateOffloadComplete. Дополнительные сведения см. в разделе распространение завершенияоперации State-Manipulation.
Из структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, переданной в функцию ProtocolUpdateOffloadComplete, промежуточный драйвер создает объект структура NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Дополнительные сведения см. в разделе Повторное использованиемструктуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. При вызове функции NdisMUpdateOffloadComplete промежуточный драйвер передает указатель (параметр OffloadBlockList) в эту только что созданную структуру NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | ndischimney.h (включая Ndischimney.h) |