FwpsQueryPacketInjectionState0 函式 (fwpsk.h)
FwpsQueryPacketInjectionState0 函式是由圖說文字呼叫,以查詢封包數據的插入狀態。
語法
FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
[in] HANDLE injectionHandle,
[in] const NET_BUFFER_LIST *netBufferList,
[out, optional] HANDLE *injectionContext
);
參數
[in] injectionHandle
先前由呼叫 所建立的插入句柄 FwpsInjectionHandleCreate0 函式。
[in] netBufferList
描述所分類封包數據的 NET_BUFFER_LIST 結構的指標。 封包可以來自網路堆疊,或者它可由一個的一個圖說文字驅動程式插入網路堆疊中。
[out, optional] injectionContext
插入內容的選擇性句柄。 如果指定指標,而且如果與插入句柄相關聯的封包插入狀態 FWPS_PACKET_INJECTION_STATE FWPS_PACKET_INJECTED_BY_SELF或FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,則會傳回插入封包時所提供的插入內容。
傳回值
FwpsQueryPacketInjectionState0 函式會傳回FWPS_PACKET_INJECTION_STATE列舉的其中一個常數值。
備註
因為插入的封包數據可以針對插入的圖說文字重新分類,所以此函式允許圖說文字在必要時檢查封包數據的插入歷程記錄,藉此避免重複檢查已檢查的封包數據。
圖說文字可以在封包數據插入時指定其中一個封包插入函式中的選擇性 injectionContext 句柄,來追蹤其他註標特定資訊。 如果 FwpsQueryPacketInjectionState0 函式傳回 FWPS_PACKET_INJECTED_BY_SELF 或 FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,則提供的 injectionContext 會當做執行插入之函式的 completionContext 參數傳回。
如果傳回值是FWPS_PACKET_INJECTED_BY_SELF或FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF,netBufferList 所指向的網路緩衝區清單就不應該進一步修改或畫筆作為複製和插入程式的一部分。 在此情況下,圖說文字應該將 classifyFn 函式之 classifyOut 參數所指向之 FWPS_CLASSIFY_OUT0 結構的 actionType 成員設定為 FWP_ACTION_CONTINUE 或 FWP_ACTION_PERMIT。 這可讓封包繼續下一個註標。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
目標平台 | Universal |
標頭 | fwpsk.h (包含 Fwpsk.h) |
程式庫 | Fwpkclnt.lib |
IRQL | <= DISPATCH_LEVEL |