Функция NdisOffloadTcpReceive (ndischimney.h)

Статья
02/07/2025

[Функция разгрузки дымохода TCP не рекомендуется и не должна использоваться.]

Драйвер протокола или промежуточный драйвер вызывает функцию NdisOffloadTcpReceive для отправки запросов на получение (буферы получения) в отключенном TCP-подключении.

Синтаксис

NDIS_STATUS NdisOffloadTcpReceive(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Параметры

[in] NdisOffloadHandle

Дескриптор структуры NDIS_OFFLOAD_HANDLE в контексте вызывающего объекта для отключенного TCP-подключения. Дополнительные сведения см. в разделе ссылки на отключенное состояние через промежуточный драйвер.

[in] NetBufferList

Указатель на структуру NET_BUFFER_LIST. Эта структура может быть автономной или первой структурой в связанном списке NET_BUFFER_LIST структур. Каждая NET_BUFFER_LIST структура в списке описывает одну NET_BUFFER структуру. Структура NET_BUFFER указывает на цепочку списков дескрипторов памяти (MDLs). NET_BUFFER_LIST и связанные структуры заблокированы, чтобы они оставались резидентными в физической памяти. Однако они не сопоставляются с системной памятью.

Возвращаемое значение

Функция NdisOffloadTcpReceive всегда возвращает NDIS_STATUS_PENDING. Операция получения всегда выполняется асинхронно.

Замечания

В ответ на вызов его функция MiniportTcpOffloadReceive, промежуточный драйвер вызывает функцию NdisOffloadTcpReceive для распространения операции получения на базовый промежуточный драйвер или целевой объект разгрузки. Дополнительные сведения см. в распространения операций ввода-вывода.

В функцию NdisOffloadTcpReceive промежуточный драйвер передает следующее:

Функция NdisOffloadHandle, которая ссылается на структуру NDIS_OFFLOAD_HANDLE, хранящуюся в контексте промежуточного драйвера для отключенного TCP-подключения. Дополнительные сведения см. в разделе ссылки на отключенное состояние через промежуточный драйвер.
Тот же указатель PNET_BUFFER_LIST, что NDIS, переданный в функцию промежуточного драйвера MiniportTcpOffloadReceive.

Когда базовый драйвер или целевой объект разгрузки впоследствии завершает операцию получения путем вызова функции NdisTcpOffloadReceiveComplete, NDIS вызывает функцию протокола ProtocolOffloadReceiveComplete. Затем промежуточный драйвер вызывает функцию NdisTcpOffloadReceiveComplete для распространения завершения операции пересылки.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ndischimney.h (включая Ndischimney.h)
библиотеки	Ndis.lib

См. также

MiniportTcpOffloadReceive

NDIS_OFFLOAD_HANDLE

NET_BUFFER

NET_BUFFER_LIST

NdisTcpOffloadReceiveComplete ProtocolTcpOffloadReceiveComplete

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