共用方式為

FwpsNetBufferListAssociateContext1 函式 (fwpsk.h)

  • 發行項

FwpsNetBufferListAssociateContext1 函式會將圖說文字驅動程式的內容與網路緩衝區清單產生關聯，並設定網路緩衝區清單事件的通知。

注意FwpsNetBufferListAssociateContext1 是 Windows 8 和更新版本中使用的特定 FwpsNetBufferListAssociateContext 版本。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定 Windows 版本為目標 。 針對 Windows 7，可以使用 FwpsNetBufferListAssociateContext0 。

 

語法

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

參數

[in, out] netBufferList

網路緩衝區清單，表示圖說文字驅動程式感興趣的一或多個封包。

[in] layerId

與內容相關聯之圖層的標識碼。 從 NDIS 接收路徑呼叫此函式時，請將此參數設定為 FWPS_LAYER_NON_WFP。

[in] context

圖說文字驅動程式所設定的任意內容資訊。 篩選引擎會將此內容傳遞至圖說文字驅動程式的
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函式。

[in] contextTag

呼叫 取得的本機唯一標識碼 FwpsNetBufferListGetTagForContext0 函式。

providerGuid

提供者 GUID。

[in, out] deviceObject

圖說文字驅動程式裝置物件的指標。

[in] notifyFn

圖說文字驅動程式 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函式的指標。 篩選引擎會將狀態通知傳送至此函式。

[in] flags

此參數保留供日後使用，且設定為零。

傳回值

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

傳回碼 Description
STATUS_SUCCESS
 關聯成功。
其他狀態代碼
 發生錯誤。

備註

FwpsNetBufferListAssociateContext1 函式會將封包群組與圖說文字驅動程式產生關聯。 您可以追蹤感興趣的封包，以透過堆疊中的多層進行檢查。

呼叫此函式之前，必須先呼叫 FwpsNetBufferListGetTagForContext0 函式，才能取得內容標記。

此函式基本上與舊版相同。

FwpsNetBufferListAssociateContext0。 唯一的差異在於 notifyFn 參數所指向的更新FWPS_NET_BUFFER_LIST_NOTIFY_FN1函式。

規格需求

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

另請參閱

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用封包標記