FltSetIoPriorityHintIntoFileObject function (fltkernel.h)

Article
02/22/2024

The FltSetIoPriorityHintIntoFileObject routine is used by a minifilter driver to set the I/O priority information in a file object.

Syntax

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

Parameters

[in] FileObject

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

[in] PriorityHint

The IO_PRIORITY_HINT enumeration value to set for the file object pointed to by FileObject.

Return value

If the I/O priority value passed in the PriorityHint parameter is successfully applied to the FileObject structure, FltSetIoPriorityHintIntoFileObject 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 I/O paths.

Requirements

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