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，圖說文字會想要在 classifyFn 傳回 (頻外修改) 之後修改複製的 net 緩衝區清單。 否則，請將 設定為 FALSE。
傳回值
無
備註
圖說文字驅動程式會呼叫 FwpsReferenceNetBufferList0 函式，以遞增 NET_BUFFER_LIST 結構的參考計數，讓網路緩衝區清單在 classifyFn 函式之外仍然有效。
例如，當圖說驅動程式重新組譯封包時，它會遞增每個接收NET_BUFFER_LIST結構的參考計數，以描述組成個別封包的封包片段。 這可讓描述重新組譯封包的新NET_BUFFER_LIST結構安全地參考記憶體描述元清單， (MDL) 由描述封包片段的NET_BUFFER_LIST結構所指向。 在圖說驅動程式將新的NET_BUFFER_LIST結構插入網路堆疊之後，它會遞減每個描述封包插入完成例程之封包片段之每個NET_BUFFER_LIST結構的參考計數。
圖說文字驅動程式必須在圖說文字驅動程式完成參考結構之後，呼叫 NET_BUFFER_LIST 結構的 FwpsDereferenceNetBufferList0 函式。
管理參考封包的指導方針
圖說文字驅動程式不得無限期保存參考的封包。 參考的封包可能會干擾閑置計算機上的電源管理作業。在一個使用者模式應用程式或其他相對快速的作業中，預期用於受參考封包的用途是取得釐清。 圖說文字驅動程式不得保存參考的封包，例如，等候使用者輸入、Web 服務清除，或任何其他可能需要任意時間的作業。
如果圖說文字驅動程式必須等候可能冗長的作業，它應該使用 FwpsAllocateNetBufferAndNetBufferList0 進行封包的深層複本，並封鎖並吸收原始封包。
圖說文字驅動程序應該一律會儘快傳回保留的封包。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows Vista 開始提供。 |
| 目標平台 | Universal |
| 標頭 | fwpsk.h (包含 Fwpsk.h) |
| 程式庫 | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |