FwpsPendClassify0 函式（fwpsk.h）

發行項
02/07/2025

圖說文字的分類Fn 函式會呼叫 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 參數。分類 fn 的 classOut 參數會列為標頭中的輸出參數，但它包含足夠的輸入資訊，以在傳遞至 FwpsPendClassify 時，對引擎有用。

傳回值

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

傳回碼	描述
STATUS_SUCCESS	分類要求已成功畫筆。
STATUS_FWP_CANNOT_PEND	引擎不允許在進行呼叫的層級進行異步分類。
其他狀態代碼	發生錯誤。

言論

FwpsPendClassify0 將指示事件的分類置於畫筆狀態。圖說文字驅動程式通常會畫筆分類，以便在分類Fn 圖說函式的範圍之外執行更多處理。然後，圖說文字驅動程式可以將分類句柄和任何其他有關指示的相關數據傳遞至比驅動程序圖說函式影響較低的函式。處理完成時，圖說文字必須呼叫 FwpsCompleteClassify0，才能移除畫筆狀態。在呼叫 FwpsCompleteClassify 時，圖說驅動程式必須傳回填寫的 FWPS_CLASSIFY_OUT0 結構，就像在內嵌分類中一樣。

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

要求

要求	價值
最低支援的用戶端	從 Windows 7 開始提供。
目標平臺	普遍
標頭	fwpsk.h （包括 Fwpsk.h）
連結庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL