共用方式為

FWPS_NET_BUFFER_LIST_NOTIFY_FN1回呼函式 （fwpsk.h）

  • 發行項

篩選引擎會呼叫 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 圖說函式，以通知圖說文字驅動程式與圖說文字標記之封包相關聯的事件。

附注 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 是 Windows 8 和更新版本中使用的特定 FWPS_NET_BUFFER_LIST_NOTIFY_FN 版本。 如需詳細資訊，請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。 針對 Windows 7，FWPS_NET_BUFFER_LIST_NOTIFY_FN0 可供使用。

 

語法

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

參數

[in] eventType

值，指出篩選引擎傳送至圖說文字的通知類型。 此參數將會設定為的其中一個值 FWPS_NET_BUFFER_LIST_EVENT_TYPE0 列舉。

[in, out] netBufferList

緩衝區清單的指標，其中包含先前由圖說驅動程序標記為有趣的封包。

[in, out, optional] newNetBufferList

更新緩衝區清單的指標，其中包含圖說驅動程式感興趣的封包。 此參數的使用會根據事件類型而有所不同。 對於對指定封包進行變更的事件，會以此參數的形式傳遞變更的版本。

[in] layerId

呼叫通知函式的圖層。

[in] context

用來標記相關封包的內容。 此值是圖說驅動程式指派給封包的值，用來識別封包。

[in] contextTag

內容標記，用來將感興趣的封包與圖說驅動程式的內容產生關聯。

傳回值

圖說文字的 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函式會傳回下列其中一個NTSTATUS程式代碼。

傳回碼 描述
STATUS_SUCCESS
 圖說文字驅動程式接受來自篩選引擎的通知。
其他狀態代碼
 發生錯誤。

言論

呼叫 FwpsNetBufferListAssociateContext1 ，此函式會與圖說文字驅動程式產生關聯。 圖說文字驅動程式可以使用單一通知函式來處理多個相關聯緩衝區清單的訊息，方法是使用內容和內容標記來區分實例。

此函式與 FWPS_NET_BUFFER_LIST_NOTIFY_FN0相同，不同之處在於傳回型別 NTSTATUS，而不是 VOID。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 窗戶
標頭 fwpsk.h （包括 Fwpsk.h）
IRQL <= DISPATCH_LEVEL

另請參閱

圖說驅動程式圖說文字函式

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

使用封包標記