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

Статья
02/07/2025

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

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.

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

Никакой

Замечания

В ответ на вызов целевого объекта драйвера или его разгрузки функцию 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.