FwpsNetBufferListRemoveContext0 函式 (fwpsk.h)

發行項
02/26/2024

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