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

Статья
08/07/2023

[Функция разгрузки tcp chimney является устаревшей и не должна использоваться.]

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

Синтаксис

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

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

Параметры

[in] ProtocolBindingContext

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

[in] NetBufferList

Если значение не равно NULL, указатель на одну NET_BUFFER_LIST структуру. Драйвер предоставил этот указатель в качестве входного параметра при предыдущем вызовеФункция NdisOffloadTcpDisconnect.

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

None

Remarks

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

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

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

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

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

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