W_TERMINATE_OFFLOAD_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

[TCP chimney 卸除功能已被取代，不應使用。

MiniportTerminateOffload 函式會終止一或多個狀態物件的卸除。

語法

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

參數

[in] MiniportAdapterContext

卸除目標所配置內容區域的句柄，卸除目標會維護此配接器實例的狀態資訊。在呼叫 NDIS 時，卸除目標會將此句柄提供給 NDIS NdisMSetMiniportAttributes from its MiniportInitializeEx 函式。

[in, out] OffloadBlockList

的指標 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構，它可以是這類結構連結清單的根目錄。這些結構會識別正在終止的卸除狀態物件。

傳回值

無

備註

MiniportTerminateOffload 函式會儲存 OffloadBlockList 指標，然後傳回。卸除目標一律會呼叫以異步方式完成終止作業 NdisMTerminateOffloadComplete 函式。

OffloadBlockList指標指向NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構，該結構可以是獨立結構或卸除狀態樹狀結構中的根區塊清單，其中包含多個NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構。這類區塊清單以及與其相關聯的任何卸除狀態結構都是有效的，直到迷你埠驅動程式呼叫 NdisMTerminateOffloadComplete 函式為止。

每個NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構都可以緊接著記憶體中的委派狀態結構 (XXX_OFFLOAD_STATE_DELEGATED) 。卸除目標會將委派的變數值複製到主機堆疊所提供的委派狀態結構。

除非符合下列兩個條件，否則主機堆疊不會要求 TCP 連線的卸除終止：