FwpsPendClassify0 函式 (fwpsk.h)

圖說文字的 classifyFn 函式會呼叫 FwpsPendClassify0 以畫筆傳送目前的分類要求。 要求畫筆之後,圖說文字驅動程式必須呼叫 FwpsCompleteClassify0以非同步方式完成分類要求的處理。

注意FwpsPendClassify0 是特定版本的 FwpsPendClassify。 如需詳細資訊 ,請參閱Version-Independent名稱和以特定版本的 Windows 為目標
 

語法

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

參數

[in] classifyHandle

分類控制碼,可識別目前層的圖說文字驅動程式處理。 呼叫 來取得此控制碼 FwpsAcquireClassifyHandle0

[in] filterId

classifyFn函式篩選參數之FilterId成員的值。 如需 FilterId 成員的詳細資訊,請參閱 FWPS_FILTER1

[in] flags

保留供未來使用。 設定為零。

[in, out] classifyOut

設定為圖說文字驅動程式的 classifyFn函式的classifyOut參數。 classifyFnclassifyOut參數會列為標頭中的輸出參數,但它包含足夠的輸入資訊,以便當傳遞至FwpsPendClassify時,對引擎很有用。

傳回值

FwpsPendClassify0函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 說明
STATUS_SUCCESS
分類要求已成功畫筆。
STATUS_FWP_CANNOT_PEND
引擎不允許在進行呼叫的圖層上進行非同步分類。
其他狀態碼
發生錯誤。

備註

FwpsPendClassify0 會將指示事件的分類置於畫筆狀態。 圖說文字驅動程式通常會畫筆分類,以便在 classificationFn 圖說文字函式的範圍之外完成更多處理。 接著,圖說文字驅動程式可以將分類控制碼和任何其他有關指示的相關資料傳遞至對效能的影響比驅動程式圖說文字函式低的函式。 處理完成時,圖說文字必須呼叫 FwpsCompleteClassify0 以移除畫筆狀態。 在呼叫 FwpsCompleteClassify 時,圖說驅動程式必須傳回填滿 的FWPS_CLASSIFY_OUT0 結構,就像內嵌分類一樣。

FwpsPendClassify0 會遞增在 classificationHandle 參數中傳遞之分類控制碼的參考計數。 圖說驅動程式呼叫此函式之後,就可以呼叫 FwpsReleaseClassifyHandle0 以釋放本機實例。 呼叫 FwpsCompleteClassify0 時,會自動遞減控制碼的參考。

規格需求

   
最低支援的用戶端 從 Windows 7 開始提供。
目標平臺 環球
標頭 fwpsk.h (包括 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

classifyFn