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

Статья
02/07/2025

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

Драйвер протокола или промежуточный драйвер вызывает функцию NdisOffloadTcpSend для передачи данных по отключенным TCP-подключению.

Синтаксис

NDIS_STATUS NdisOffloadTcpSend(
  [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 и связанные структуры заблокированы, чтобы они оставались резидентными в физической памяти. Однако они не сопоставляются с системной памятью.

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

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

Замечания

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

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

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

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

Требования

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