FwpsReferenceNetBufferList0 函式 (fwpsk.h)
FwpsReferenceNetBufferList0 函式會遞增 NET_BUFFER_LIST 結構的參考計數。
語法
void FwpsReferenceNetBufferList0(
[in, out] NET_BUFFER_LIST *netBufferList,
[in] BOOLEAN intendToModify
);
參數
[in, out] netBufferList
參考計數遞增之 NET_BUFFER_LIST 結構的指標。
[in] intendToModify
值,指出圖說文字是否打算修改複製的網路緩衝區清單,其父系是由 netBufferList 參數所指向,在傳回 classifyFn 函式之後。 如果 TRUE,圖說文字會在傳回 分類Fn 之後修改複製的凈緩衝區清單(頻外修改)。 否則,請將 設為 FALSE。
傳回值
沒有
言論
圖說文字驅動程式會呼叫 FwpsReferenceNetBufferList0 函式,以遞增 NET_BUFFER_LIST 結構的參考計數,讓網路緩衝區清單在分類Fn 函式 之外仍然有效。
例如,當圖說文字驅動程序執行封包重新組譯時,它會遞增每個已接收NET_BUFFER_LIST結構的參考計數,以描述組成個別封包的封包片段。 這可讓描述重新組譯封包的新NET_BUFFER_LIST結構安全地參考描述元清單 (MDL) 所指向的NET_BUFFER_LIST結構,以描述封包片段。 在註標驅動程式將新的NET_BUFFER_LIST結構插入網路堆疊之後,它會遞減每個描述封包插入完成例程之封包片段的NET_BUFFER_LIST結構的參考計數。
圖說文字驅動程式必須在圖說驅動程式完成參考結構之後,針對NET_BUFFER_LIST結構呼叫 FwpsDereferenceNetBufferList0 函式。
管理參考封包的 指導方針
圖說文字驅動程式不得無限期保存參考的封包。 參考的封包可能會干擾閑置計算機上的電源管理作業。糧食計劃署中參考封包的用途是從使用者模式應用程式或其他相對快速的作業取得釐清。 圖說文字驅動程式不得保存參考的封包,例如,等候使用者輸入、Web 服務清除,或任何其他可能需要任意時間的作業。
如果圖說驅動程式必須等候可能冗長的作業,它應該使用 FwpsAllocateNetBufferAndNetBufferList0 並封鎖並吸收原始封包,進行封包的深層複本。
圖說文字驅動程序應該一律會儘快傳回保留的封包。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
目標平臺 | 普遍 |
標頭 | fwpsk.h (包括 Fwpsk.h) |
連結庫 | Fwpkclnt.lib |
IRQL | <= DISPATCH_LEVEL |