W_QUERY_OFFLOAD_HANDLER回呼函式 (ndischimney.h)
[TCP 煙囪卸除功能已被取代,不應使用。]
MiniportQueryOffload 函式查詢先前卸除的 TCP 煙囪狀態物件。
語法
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 MiniportInitializeEx 函式。
[in, out] OffloadBlockList
的指標 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 結構,它可以是這類結構連結清單的根目錄。 這些結構會識別正在查詢的卸除狀態。
傳回值
沒有
言論
MiniportQueryOffload 函式可以查詢任何已卸除至卸除目標的 TCP 煙囪狀態。
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結構 成員:
-
NDIS_STATUS_SUCCESS
卸除目標已成功查詢狀態物件。
-
NDIS_STATUS_FAILURE
查詢作業沒有成功。 主機堆疊將會終止無法查詢的狀態物件。
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | ndischimney.h (包括 Ndischimney.h) |
IRQL | 任何層級 |