FltSetIoPriorityHintIntoFileObject function

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

Syntax

NTSTATUS FltSetIoPriorityHintIntoFileObject(
  _In_ PFILE_OBJECT     FileObject,
  _In_ IO_PRIORITY_HINT PriorityHint
);

Parameters

FileObject

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

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

   
Windows version Available 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

FltGetIoPriorityHintFromThread

FltSetIoPriorityHintIntoCallbackData

FltRetrieveIoPriorityInfo

FltGetIoPriorityHintFromFileObject

FltApplyPriorityInfoThread

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltSetIoPriorityHintIntoThread

IO_PRIORITY_HINT

Send comments about this topic to Microsoft