INITIATE_OFFLOAD_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

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

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結構。