FltApplyPriorityInfoThread 函式 (fltkernel.h)

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 值,例如下列其中一項:

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

備註

此常式從 Windows Vista 開始可供使用。

FltApplyPriorityInfoThread常式會根據InputPriorityInfo參數所指向之IO_PRIORITY_INFO結構的成員值,設定指定執行緒的 I/O 優先順序、分頁優先順序和執行緒優先順序。 這可讓 FltRetrieveIoPriorityInfoFltApplyPriorityInfoThread 常式所取得的優先順序資訊集,套用至執行緒。

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

InputPriorityInfoOutputPriorityInfo 參數提供單一IO_PRIORITY_INFO結構的相同指標是安全的。

注意 如果未設定 InputPriorityInfo 參數所指向之IO_PRIORITY_INFO結構的成員值,您必須先設定這些成員,再呼叫 FltApplyPriorityInfoThread 常式,方法是使用下列其中一種方法:
  • 呼叫 FltRetrieveIoPriorityInfo 常式。
  • 請確定目前的InputPriorityInfo參數是FltApplyPriorityInfoThread常式之前呼叫中的OutputPriorityInfo 參數
 

必要條件

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

另請參閱

FLT_CALLBACK_DATA

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoFileObject

FltSetIoPriorityHintIntoThread

IO_PRIORITY_INFO