функция обратного вызова W_QUERY_OFFLOAD_HANDLER (ndischimney.h)
[Функция разгрузки tcp chimney является устаревшей и не должна использоваться.]
Функция MiniportQueryOffload запрашивает ранее разгруженные объекты состояния tcp chimney.
Синтаксис
W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;
void WQueryOffloadHandler(
[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 структуры, которая может быть корнем связанного списка таких структур. Эти структуры определяют состояние разгрузки, к которому выполняется запрос.
Возвращаемое значение
None
Remarks
Функция MiniportQueryOffload может запрашивать любое состояние дымохода TCP, которое было выгружено в целевой объект разгрузки.
Функция MiniportQueryOffload сохраняет указатель OffloadBlockList , а затем возвращает . Целевой объект разгрузки всегда асинхронно завершает операцию запроса путем вызоваФункция NdisMQueryOffloadStateComplete. Указатель OffloadBlockList указывает на NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структуру, которая может быть автономной структурой или корневым узлом в дереве состояния разгрузки. Дерево состояния является допустимым до тех пор, пока целевой объект разгрузки не вызовет функцию NdisMQueryOffloadStateComplete .
После возврата из функции MiniportQueryOffload драйвер мини-порта заполняет структуру состояния разгрузки , связанную с каждой NDIS_MINIPORT_OFFLOAD_BLOCK_LIST структурой в дереве состояния, на которую указывает указатель OffloadBlockList . Для каждой из этих структур состояния разгрузки драйвер мини-порта записывает текущее значение каждой переменной в структуре.
Перед вызовом функции NdisMQueryOffloadStateComplete целевой объект разгрузки должен записать одно из следующих значений NDIS_STATUS в элемент Status каждой структуры NDIS_MINIPORT_OFFLOAD_BLOCK_LIST в дереве состояния:
-
NDIS_STATUS_SUCCESS
Целевой объект разгрузки успешно запросил объекты состояния.
-
NDIS_STATUS_FAILURE
Операция запроса не выполнена. Стек узлов завершит работу объектов состояния, которые не удалось запросить.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | ndischimney.h (включая Ndischimney.h) |
| IRQL | Любой уровень |