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

функция обратного вызова 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 Любой уровень

См. также раздел

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes