FwpsPendClassify0 函式 (fwpsk.h)

發行項
02/29/2024

圖說文字的 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 參數。 classifyFn 的 classifyOut 參數會列為標頭中的輸出參數，但它包含足夠的輸入資訊，以便當傳遞至 FwpsPendClassify 時，對引擎很有用。

傳回值

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

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

備註

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

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

規格需求

需求	值
最低支援的用戶端	從 Windows 7 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL