共用方式為

FwpsNetBufferListRemoveContext0 函式 （fwpsk.h）

  • 發行項

FwpsNetBufferListRemoveContext0 函式會移除與網路緩衝區清單相關聯的內容。

NoteFwpsNetBufferListRemoveContext0 是 FwpsNetBufferListRemoveContext 的特定版本。 如需詳細資訊，請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。
 

語法

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

參數

[in, out, optional] netBufferList

網路緩衝區清單，指出圖說文字驅動程式感興趣的一或多個封包。 這個參數是選擇性的，而且可以 NULL。 如果它是 NULL，函式會從所有相關聯的網路緩衝區清單中移除內容。

[in] contextTag

傳遞至 contextTag 參數的內容標記，FwpsNetBufferListAssociateContext0。

[in] flags

此參數保留供日後使用，且必須是零。

傳回值

FwpsNetBufferListRemoveContext0 函式會傳回下列其中一個 NTSTATUS 碼。

傳回碼 描述
STATUS_SUCCESS
 已成功移除內容。
其他狀態代碼
 發生錯誤。

言論

FwpsNetBufferListRemoveContext0 函式會以異步方式移除與網路緩衝區清單相關聯的標記內容。

若要將內容與網路緩衝區清單產生關聯，請呼叫 FwpsNetBufferListAssociateContext0 或 FwpsNetBufferListAssociateContext1。

通常，圖說文字驅動程式不需要使用此函式，因為當封包通過堆棧移動時，會自動移除標記的內容。 提供此函式，讓圖說文字驅動程式可以在內容不會自動移除的情況下停止處理。 例如，在 NDIS 篩選驅動程序的情況下，封包永遠不會輸入 TCP/IP 堆棧，而且必須藉由呼叫 FwpsNetBufferListRemoveContext0，將 netBufferList 參數設為 NULL來手動移除內容。

要求

要求 價值
最低支援的用戶端 從 Windows 7 開始提供。
目標平臺 普遍
標頭 fwpsk.h （包括 Fwpsk.h）
連結庫 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用封包標記