共用方式為

W_QUERY_OFFLOAD_HANDLER回呼函式 (ndischimney.h)

  • 發行項

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

MiniportQueryOffload 函式會查詢先前卸除 TCP chimney 狀態物件。

語法

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

參數

[in] MiniportAdapterContext

卸除目標所配置內容區域的句柄，卸除目標會維護此配接器實例的狀態資訊。 在呼叫 NDIS 時，卸除目標會將此句柄提供給 NDIS NdisMSetMiniportAttributes from its MiniportInitializeEx 函式。

[in, out] OffloadBlockList

的指標 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構，它可以是這類結構連結清單的根目錄。 這些結構會識別正在查詢的卸除狀態。

傳回值

無

備註

MiniportQueryOffload 函式可以查詢已卸除至卸除目標的任何 TCP chimney 狀態。

MiniportQueryOffload 函式會儲存 OffloadBlockList 指標，然後傳回 。 卸除目標一律會呼叫 以異步方式完成查詢作業 NdisMQueryOffloadStateComplete 函式 。 OffloadBlockList 指標指向 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構，可以是獨立結構或 卸除狀態樹狀結構中的根節點。 狀態樹狀結構有效，直到卸除目標呼叫 NdisMQueryOffloadStateComplete 函式 為止。

從 MiniportQueryOffload 函式傳回之後，迷你埠驅動程式會填入與 OffloadBlockList 指標所指向之狀態樹狀結構中每個NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構相關聯的卸除狀態結構。 針對每個卸除狀態結構，迷你埠驅動程式會在 結構中寫入每個變數的目前值。

呼叫 NdisMQueryOffloadStateComplete 函式之前，卸除目標必須將下列任一個NDIS_STATUS值寫入狀態樹狀結構中每個NDIS_MINIPORT_OFFLOAD_BLOCK_LIST結構的 Status 成員：

  • NDIS_STATUS_SUCCESS

    卸除目標已成功查詢狀態物件。

  • NDIS_STATUS_FAILURE

    查詢作業未成功。 主機堆疊將會終止無法查詢的狀態物件。

規格需求

需求 值
目標平台 Windows
標頭 ndischimney.h (包括 Ndischimney.h)
IRQL 任何層級

另請參閱

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes