共用方式為

FwpsNetBufferListAssociateContext0 函式 (fwpsk.h)

  • 發行項

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

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

語法

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 notifyFn,
  [in]      UINT32                          flags
);

參數

[in, out] netBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

providerGuid

提供者 GUID。

[in, out] deviceObject

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

[in] notifyFn

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

[in] flags

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

傳回值

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

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

備註

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

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

規格需求

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

另請參閱

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用封包標記