FwpsQueryPacketInjectionState0 函式（fwpsk.h）

發行項
02/07/2025

FwpsQueryPacketInjectionState0 函式是由圖說文字呼叫，以查詢封包數據的插入狀態。

NoteFwpsQueryPacketInjectionState0 是 FwpsQueryPacketInjectionState 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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 結構的指標。封包可以來自網路堆疊，也可以由WFP 圖說文字驅動程式插入網路堆疊。

[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 開始提供。
目標平臺	普遍
標頭	fwpsk.h （包括 Fwpsk.h）
連結庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL