INVALIDATE_OFFLOAD_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

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

NDIS 會呼叫通訊協定驅動程式或中繼驅動程式的 ProtocolInvalidateOffloadComplete 函式，以完成驅動程式先前藉由呼叫 NdisInvalidateOffload 函式起始的無效作業。

語法

INVALIDATE_OFFLOAD_COMPLETE_HANDLER InvalidateOffloadCompleteHandler;

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

參數

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

傳回值

無

備註

回應基礎卸除目標的或中繼驅動程式對的呼叫 NdisMInvalidateOffloadComplete 函式，NDIS 會呼叫過度分配的通訊協定或中繼驅動程式
ProtocolInvalidateOffloadComplete 函 式。

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

從傳遞至 其 ProtocolInvalidateOffloadComplete 函式的 NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST 結構，中繼驅動程式會建構 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構。如需詳細資訊，請參閱重複使用NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST結構。呼叫 NdisMInvalidateOffloadComplete 函式時，中繼驅動程式會將指標 (OffloadBlockList 參數) 傳遞至這個新建構NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構。