共用方式為

FwpsNetBufferListRemoveContext0 函式 (fwpsk.h)

  • 發行項

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

注意FwpsNetBufferListRemoveContext0 是特定版本的 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 程式代碼。

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

備註

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

若要建立內容與網路緩衝區清單的關聯，請呼叫 FwpsNetBufferListAssociateContext0 或 FwpsNetBufferListAssociateContext1。

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

規格需求

需求 值
最低支援的用戶端 從 Windows 7 開始提供。
目標平台 Universal
標頭 fwpsk.h (包含 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用封包標記