共用方式為

FwpsReferenceNetBufferList0 函式 (fwpsk.h)

  • 發行項

FwpsReferenceNetBufferList0 函式會遞增NET_BUFFER_LIST結構的參考計數。

注意FwpsReferenceNetBufferList0 是 特定版本的 FwpsReferenceNetBufferList。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。
 

語法

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

另請參閱

FwpsDereferenceNetBufferList0

NET_BUFFER_LIST

classifyFn