FWPS_INJECT_COMPLETE0回呼函式 (fwpsk.h)

發行項
02/26/2024

每當封包數據，netBufferList 參數在其中一個封包插入函式中描述的封包數據時，篩選引擎就會呼叫圖說文字的完成Fn 圖說文字函式，已插入網路堆疊中。

語法

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

參數

[in] context

圖說文字驅動程式所呼叫之其中一個封包插入函式的 completionContext 參數指標。

[in, out] netBufferList

在圖說文字驅動程式所呼叫之其中一個封包插入函式的 netBufferList 參數中傳遞的指標。

[in] dispatchLevel

值，指出 正在呼叫 completionFn 圖說文字函式的 IRQL。如果此參數為 TRUE，則會在 IRQL = DISPATCH_LEVEL呼叫 completionFn 圖說文字函式。如果此參數為 FALSE，則會在 IRQL < DISPATCH_LEVEL呼叫 completionFn 圖說文字函式。

傳回值

無

備註

FWPS_INJECT_COMPLETE0類型定義為 completionFn 函式的指標，如下所示：

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

NetBufferList 所指向之NET_BUFFER_LIST結構的 Status 成員表示插入作業的結果。

在複製或建立 NET_BUFFER_LIST 結構鏈結中的封包數據成功由其中一個封包插入函式插入網路堆疊之後， 就會呼叫 completionFn 。

如果呼叫 FwpsStreamInjectAsync0 函式來插入NET_BUFFER_LIST結構的鏈結，則每次使用 FwpsStreamInjectAsync0 中指定的相同 completionContext 參數時，都會針對鏈結中的每個NET_BUFFER_LIST呼叫 completionFn 一次。在此情況下，圖說文字驅動程式的 完成Fn 實作應該呼叫 FwpsFreeCloneNetBufferList0 以釋放目前指定的 NET_BUFFER_LIST。

篩選引擎會在 IRQL <= DISPATCH_LEVEL呼叫圖說文字的完成Fn 圖說文字函式。