FltSetIoPriorityHintIntoFileObject 函式 (fltkernel.h)

小型篩選驅動程式會使用 FltSetIoPriorityHintIntoFileObject 例程,在檔案物件中設定 I/O 優先順序資訊。

語法

NTSTATUS FLTAPI FltSetIoPriorityHintIntoFileObject(
  [in] PFILE_OBJECT     FileObject,
  [in] IO_PRIORITY_HINT PriorityHint
);

參數

[in] FileObject

要修改之檔案物件的指標。 這個參數是必要的,而且不能是 NULL

[in] PriorityHint

要為 FileObject 指向的檔案物件設定的IO_PRIORITY_HINT列舉值。

傳回值

如果 PriorityHint 參數中傳遞的 I/O 優先順序值已成功套用至 FileObject 結構, FltSetIoPriorityHintIntoFileObject 會傳回STATUS_SUCCESS。 否則,它會傳回適當的NTSTATUS值,例如下列其中一項:

傳回碼 Description
STATUS_INVALID_PARAMETER
PriorityHint 參數的值無效。 這是錯誤碼。

備註

此例程為 NONPAGED,可從分頁 I/O 路徑呼叫。

規格需求

需求
最低支援的用戶端 從 Windows Vista 開始提供。
目標平台 Universal
標頭 fltkernel.h (包含 FltKernel.h)
程式庫 FltMgr.lib
Dll Fltmgr.sys
IRQL <= DISPATCH_LEVEL

另請參閱

FLT_CALLBACK_DATA

FltApplyPriorityInfoThread

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoThread

IO_PRIORITY_HINT