QUERY_OFFLOAD_COMPLETE_HANDLER回呼函式 (ndischimney.h)

發行項
02/29/2024

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

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

語法

QUERY_OFFLOAD_COMPLETE_HANDLER QueryOffloadCompleteHandler;

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

參數

[in] ProtocolBindingContext

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

[in] OffloadBlockList

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

傳回值

無

備註

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

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

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