функция обратного вызова W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER (ndischimney.h)

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

NDIS вызывает функцию MiniportTcpOffloadReceiveReturn , чтобы вернуть права владения NET_BUFFER_LIST и связанными структурами в целевой объект разгрузки.

Синтаксис

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор выделенной области контекста целевого объекта разгрузки, в которой целевой объект разгрузки сохраняет сведения о состоянии этого экземпляра адаптера. Драйвер минипорта предоставил этот дескриптор NDIS при вызове NdisMSetMiniportAttributes из его Функция MiniportInitializeEx .

[in] NetBufferList

Указатель на структуру NET_BUFFER_LIST . Эта структура может быть автономной или первой структурой в связанном списке NET_BUFFER_LIST структур. Связанный список может содержать NET_BUFFER_LIST структур из одного или нескольких вызовов кФункция NdisTcpOffloadReceiveHandler.

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

Функция MiniportTcpOffloadReceiveReturn всегда должна выполняться успешно. Поэтому функция MiniportTcpOffloadReceiveReturn всегда должна возвращать NDIS_STATUS_SUCCESS.

Комментарии

NDIS вызывает функцию MiniportTcpOffloadReceiveReturn , чтобы вернуть права собственности на NET_BUFFER_LIST структуры и связанные структуры, которые целевой объект разгрузки передал в одном или нескольких предыдущих вызовахФункция NdisTcpOffloadReceiveHandler.

Функция MiniportTcpOffloadReceiveReturn может подготовить возвращаемую структуру NET_BUFFER_LIST для использования в последующем указании получения. Хотя функция MiniportTcpOffloadReceiveReturn может возвращать NET_BUFFER_LIST структуры в пул (например, она может вызывать функцию NdisFreeNetBufferList ), может быть эффективнее повторно использовать структуры, не возвращая их в пул.

Обратите внимание, что драйвер целевого объекта разгрузки не должен выгружать, а адаптер целевого объекта разгрузки не должен быть закрыт до тех пор, пока не будут возвращены все указанные буферы приема.

Требования

Требование Значение
Целевая платформа Windows
Header ndischimney.h (включая Ndischimney.h)
IRQL Любой уровень

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

MiniportInitializeEx

NET_BUFFER

NET_BUFFER_LIST

NdisFreeNetBufferList

NdisMSetMiniportAttributes

NdisTcpOffloadReceiveHandler