NdisMTerminateOffloadComplete 函式 (ndischimney.h)

發行項
04/03/2024

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

卸除目標會呼叫 NdisMTerminateOffloadComplete 函式，以完成先前呼叫所起始的終止卸載作業卸除目標的 MiniportTerminateOffload 函式。

語法

void NdisMTerminateOffloadComplete(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
);

參數

[in] NdisMiniportHandle

卸除目標在先前呼叫中取得的句柄 NdisMRegisterMiniportDriver。

[in] OffloadBlockList

的指標 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構。卸除目標取得此指標做為其輸入參數 MiniportTerminateOffload 函式。

傳回值

無

備註

呼叫 NdisMTerminateOffloadComplete 函式之前，卸除目標必須將下列任一NDIS_STATUS值寫入狀態樹狀結構中每個NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構的 Status 成員：

NDIS_STATUS_SUCCESS
卸除目標已成功終止NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構所參考的狀態物件卸除。如果NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構後面接著委派的狀態結構 (XXX_OFFLOAD_STATE_DELEGATED) ，卸除目標已成功將該狀態物件的委派變數值寫入委派狀態結構。
NDIS_STATUS_FAILURE
終止作業未成功。這類失敗是由導致中斷狀態物件的嚴重失敗所造成。在此情況下，卸除目標硬體可能不會回應。主機堆疊可能必須中止連線。

在呼叫 NdisMTerminateOffloadComplete 函式之前，卸除目標也必須：

完成 MiniportInvalidateOffload、 MiniportQueryOffload、 MiniportTcpOffloadReceive 的任何未完成呼叫 MiniportTcpOffloadDisconnect、 MiniportTcpOffloadForward、 MiniportTcpOffloadSend 和 MiniportUpdateOffload 函式。
確定 NdisMIndicateStatusEx、 NdisMOffloadEventIndicate、 NdisTcpOffloadEventHandler 和 NdisTcpOffloadReceiveHandler 函式已傳回。

如果在終止的 TCP 連線上有未完成的傳送數據，卸除目標套件會在 net 緩衝區中這類數據，並將封裝的數據傳遞至連結清單中的主機堆疊NET_BUFFER_LIST 結構。在此情況下，卸除目標會針對該連線之NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構的 NetBufferListChain 成員指定非 NULL 值。 (NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構位於 OffloadBlockList 指標所指向的連結清單中。) NetBufferListChain 成員會指向與傳送數據相關聯 之NET_BUFFER_LIST 結構的連結清單。

將未處理傳送的數據傳遞至主機堆疊時，卸除目標也必須針對正在終止的連接指定下列委派 TCP 變數的非 NULL 值：