INITIATE_OFFLOAD_COMPLETE_HANDLER回呼函式（ndischimney.h）

發行項
02/07/2025

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

NDIS 會呼叫通訊協定驅動程式或中繼驅動程式的 ProtocolInitiateOffloadComplete 函式，以完成驅動程式先前呼叫 NdisInitiateOffload 函式所起始的卸除作業。

語法

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

參數

[in] ProtocolBindingContext

通訊協定驅動程式所配置之內容區域的句柄。驅動程式會在此內容區域中維護每個系結內容資訊。當驅動程式呼叫 NdisOpenAdapterEx 函式時，驅動程式會提供此句柄給 NDIS。

[in] OffloadBlockList

NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 結構的指標，可以是獨立結構或這類結構連結清單的根目錄。這些結構會識別卸除或嘗試卸除的狀態。

傳回值

沒有

言論

為了回應基礎卸除目標或中繼驅動程式呼叫 NdisMInitiateOffloadComplete 函式，NDIS 會呼叫過度裝載通訊協定或中繼驅動程式的 ProtocolInitiateOffloadComplete 函式。

中繼驅動程式必須呼叫 NdisMInitiateOffloadComplete，將起始卸除作業的完成傳播至其上方的驅動程式。如需詳細資訊，請參閱傳播完成 State-Manipulation 作業。

從傳遞至其 ProtocolInitiateOffloadComplete 函式的 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 結構中，中繼驅動程式會建構 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構。

如需詳細資訊，請參閱重複使用NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST結構。呼叫 NdisMInitiateOffloadComplete 函式時，中繼驅動程式會將指標（OffloadBlockList 參數）傳遞給這個新建構的NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構。