FltSetIoPriorityHintIntoThread function (fltkernel.h)

The FltSetIoPriorityHintIntoThread routine is used by a minifilter driver to set the IO priority information in a thread.

Syntax

NTSTATUS FLTAPI FltSetIoPriorityHintIntoThread(
  [in] PETHREAD         Thread,
  [in] IO_PRIORITY_HINT PriorityHint
);

Parameters

[in] Thread

A pointer to the thread to modify. This parameter is required and cannot be NULL.

[in] PriorityHint

The IO_PRIORITY_HINT enumeration value to set for the thread information pointed to by Thread.

Return value

If the IO Priority value passed to the PriorityHint parameter is successfully applied to the Thread, FltSetIoPriorityHintIntoThread returns STATUS_SUCCESS. Otherwise, it returns an appropriate NTSTATUS value, such as one of the following:

Return code Description
STATUS_INVALID_PARAMETER
The value of the PriorityHint parameter is invalid. This is an error code.

Remarks

This routine is NONPAGED and can be called from paging IO paths.

Requirements

Requirement Value
Minimum supported client Available in starting with Windows Vista.
Target Platform Universal
Header fltkernel.h (include FltKernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

See also

FLT_CALLBACK_DATA

FltApplyPriorityInfoThread

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoFileObject

IO_PRIORITY_HINT