FltApplyPriorityInfoThread 函式 (fltkernel.h)

發行項
03/01/2024

Minifilter 驅動程式會使用 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值，例如下列其中一項：

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

備註

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

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

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

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

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

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

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL