FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0回呼函式 (fwpsu.h)
篩選引擎會呼叫圖說文字的 flowDeleteFn 圖說文字函式,以通知圖說文字正在終止所處理的數據流。
語法
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;
void FwpsCalloutFlowDeleteNotifyFn0(
UINT16 layerId,
UINT32 calloutId,
UINT64 flowContext
)
{...}
參數
layerId
要終止數據流之篩選層的運行時間標識碼。 如需詳細資訊,請參閱 篩選圖層標識符。
calloutId
篩選引擎中圖說文字的運行時間標識碼。 這是呼叫 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函式以向篩選引擎註冊圖說文字時所傳回的相同標識碼。
flowContext
呼叫 FwpsFlowAssociateContext0 函式,與數據流相關聯的最近內容。
傳回值
無
備註
圖說文字驅動程式會藉由呼叫 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函式,向篩選引擎註冊圖說文字的圖說文字函式。
篩選引擎會在終止數據流時呼叫圖說文字的 flowDeleteFn 圖說文字函式,讓圖說文字可以清除與數據流相關聯的內容。 例如,此圖說文字函式會在 RST 突然停止之後呼叫,而不會先呼叫 classifyFn 。 只有當圖說文字驅動程式與數據流產生關聯時,篩選引擎才會呼叫這個圖說文字函式。 當數據流終止時,篩選引擎會自動從數據流中移除內容。
篩選引擎只會在支持數據流的篩選層上,呼叫圖說文字 的 flowDeleteFn 圖說文字函式時,才支持數據流的篩選層,而圖說文字驅動程式會將內容與其處理的數據流產生關聯。 如果圖說驅動程式未將內容與圖說文字處理的數據流產生關聯,則不應該實作圖說文字的 flowDeleteFn 圖說文字函式。 在此情況下,圖說文字驅動程式應該在向篩選引擎註冊圖說文字時,將 FWPS_CALLOUT0 結構的 flowDeleteFn 成員設定為 NULL。
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0類型定義為 flowDeleteFn 函式的指標,如下所示。
typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn
篩選引擎會在 IRQL <= DISPATCH_LEVEL呼叫圖說文字的 flowDeleteFn 圖說文字函式。
規格需求
需求 | 值 |
---|---|
標頭 | fwpsu.h |