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

Статья
02/07/2025

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

NDIS вызывает функцию протокола или промежуточного драйвера ProtocolTcpOffloadReceiveComplete, чтобы завершить операцию получения, инициированную драйвером, вызвав функцию NdisOffloadTcpReceive.

Синтаксис

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

void TcpOffloadRecvCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Параметры

[in] ProtocolBindingContext

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

[in] NetBufferList

Указатель на структуру NET_BUFFER_LIST. Эта структура может быть автономной или первой в связанном списке NET_BUFFER_LIST структур. Драйвер предоставил этот указатель в качестве входного параметра в предыдущем вызове функция NdisOffloadTcpReceive.

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

Никакой

Замечания

В ответ на вызов целевого объекта драйвера или его разгрузки функции NdisOffloadTcpReceiveComplete, NDIS вызывает функцию драйвера протокола или промежуточного драйвера ProtocolTcpOffloadReceiveComplete.

Чтобы распространить завершение операции ввода-вывода на драйвер переопределения, промежуточный драйвер вызывает функцию NdisOffloadTcpReceiveComplete, передав следующую команду:

ProtocolBindingContext, который является дескриптором, который однозначно идентифицирует промежуточный драйвер.
Указатель PNET_BUFFER_LIST, передаваемый NDIS в функцию промежуточного драйвера ProtocolTcpOffloadReceiveComplete.

В ответ NDIS вызывает функцию драйвера ProtocolTcpOffloadReceiveComplete, передав дескриптор протокола ProtocolBindingContext и указатель PNET_BUFFER_LIST, предоставленный промежуточным драйвером функции NdisOffloadTcpReceiveComplete.