UPDATE_OFFLOAD_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/26/2024

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

NDIS 會呼叫通訊協定驅動程式或中繼驅動程式的 ProtocolUpdateOffloadComplete 函式，以完成驅動程式先前藉由呼叫 NdisUpdateOffload 函式起始的更新卸除作業。

語法

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

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

參數

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

傳回值

無

備註

回應基礎卸除目標的或中繼驅動程式對的呼叫 NdisMUpdateOffloadComplete 函式，NDIS 會呼叫通訊協定或中繼驅動程式的 ProtocolUpdateOffloadComplete 函式。

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

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