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代碼。

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

備註

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

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

規格需求

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

另請參閱

圖說文字驅動程序註標函式

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

使用封包標記