FltApplyPriorityInfoThread 函式（fltkernel.h）

發行項
02/06/2025

小型篩選驅動程式會使用 FltApplyPriorityInfoThread 例程，將優先順序資訊套用至線程。

語法

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

參數

[in] InputPriorityInfo

IO_PRIORITY_INFO 結構的指標，用來設定指定線程的優先順序狀態。此IO_PRIORITY_INFO結構必須由適當的例程設定其成員 - 請參閱下列一節。這是必要參數，而且無法 NULL。

[out, optional] OutputPriorityInfo

IO_PRIORITY_INFO結構的選擇性指標，用來在 InputPriorityInfo 優先順序資訊之前接收線程的優先順序狀態，FltApplyPriorityInfoThread套用至線程。這個參數是選擇性的，而且可以 NULL。

[in] Thread

要在其中套用 InputPriorityInfo 優先順序資訊的線程指標。這是必要參數，而且無法 NULL。

傳回值

如果 InputPriorityInfo 參數指向的線程優先順序資訊已成功套用至指定的線程，FltApplyPriorityInfoThread 例程會傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS值，例如下列其中一個：

傳回碼	描述
STATUS_INVALID_PARAMETER_1	InputPriorityInfo 參數所指向的結構已初始化，但其中一或多個成員值無效。這是錯誤碼。

言論

從 Windows Vista 開始，即可使用此例程。

FltApplyPriorityInfoThread 例程會根據 InputPriorityInfo 參數所指向之IO_PRIORITY_INFO結構的成員值，設定指定線程的 I/O 優先順序、分頁優先順序和線程優先順序。這可讓先前儲存的一組優先順序資訊，由 FltRetrieveIoPriorityInfo 或 FltApplyPriorityInfoThread 例程所取得，套用至線程。

目標線程的原始值，在 InputPriorityInfo 優先順序值之前，FltApplyPriorityInfoThread 例程，可以在提供有效的 outputPriorityInfo 指標之前儲存。請注意，OutputPriorityInfo 所指向的結構不需要初始化 參數。

針對 InputPriorityInfo 和 OutputPriorityInfo 參數，為單一IO_PRIORITY_INFO結構提供相同的指標是安全的。

Note 如果 InputPriorityInfo 參數所指向IO_PRIORITY_INFO結構的成員值尚未設定，您必須先設定這些成員，才能呼叫 FltApplyPriorityInfoThread 例程，方法是使用下列其中一種方法：

呼叫 FltRetrieveIoPriorityInfo 例程。
請確定目前的 InputPriorityInfo 參數是之前呼叫 FltApplyPriorityInfoThread 例程中的 OutputPriorityInfoInfo 參數。

要求

要求	價值
最低支援的用戶端	Microsoft Windows Vista 和更新版本的 Windows作系統中提供。
目標平臺	普遍
標頭	fltkernel.h （包括 Fltkernel.h）
連結庫	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL