FltSetIoPriorityHintIntoThread function (fltkernel.h)

Article
02/22/2024

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