TCP_OFFLOAD_EVENT_HANDLER回呼函式 (ndischimney.h)
[TCP chimney 卸除功能已被取代,不應使用。]
NDIS 會呼叫通訊協定驅動程式或中繼驅動程式的 ProtocolIndicateOffloadEvent 函式,以張貼基礎驅動程式或卸除目標對的呼叫所起始的指示 NdisTcpOffloadEventHandler 函 式。
語法
TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;
void TcpOffloadEventHandler(
[in] IN PVOID OffloadContext,
[in] IN ULONG EventType,
[in] IN ULONG EventSpecificInformation
)
{...}
參數
[in] OffloadContext
通訊協定或中繼驅動程式 的NDIS_OFFLOAD_HANDLE 結構指標,用於進行指示的 TCP 連線。 卸除連接時,通訊協定或中繼驅動程式會將此指標當做輸入參數提供給 NdisInitiateOffload 函式。
[in] EventType
表示為下列其中一個TCP_OFFLOAD_EVENT_TYPE值的事件:
TcpIndicateDisconnect
表示遠端主機藉由在連線上傳送 FIN 區段來起始正常中斷連線。
TcpIndicateRetrieve
表示卸除目標要求主機堆疊終止 TCP 連線的卸除。
TcpIndicateAbort
表示遠端主機藉由在連線上傳送可接受的 RST 區段來起始中止中斷連線。
TcpIndicateSendBacklogChange
表示慣用傳送待辦專案大小的變更。
[in] EventSpecificInformation
指定所指出事件的其他資訊,如下所示:
TcpIndicateDisconnect
不有意義。
TcpIndicateRetrieve
指出上傳要求為TCP_UPLOAD_REASON值的原因。 如需相關資訊,請參閱 NdisTcpOffloadEventHandler。
TcpIndicateAbort
不有意義。
TcpIndicateSendBacklogChange
指定主機堆疊在卸除目標上應有未處理的最佳傳送數據位元組數目,以達到最佳的數據輸送量。
傳回值
無
備註
若要將指示傳播至過度使用的驅動程式或主機堆棧,中繼驅動程式會呼叫 NdisTcpOffloadEventHandler 函式。 中繼驅動程式會將下列參數傳遞至
NdisTcpOffloadEventHandler 函式:
- 卸除目標儲存在卸除 TCP 連線內容的 NdisOffloadHandle 。 如需相關資訊,請參閱 透過中繼驅動程序參考卸除狀態。
- NDIS 傳遞至中繼驅動程式 ProtocolTcpOffloadEvent 函式的 EventType。
- NDIS 傳遞至中繼驅動程式 ProtocolTcpOffloadEvent 函式的 EventSpecificInformation。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | ndischimney.h (包含 Ndischimney.h) |