FltSetIoPriorityHintIntoFileObject routine

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 [in]

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

PriorityHint [in]

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 codeDescription
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

Target platform

Universal

Version

Available starting with Windows Vista.

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
FltSetIoPriorityHintIntoThread
IO_PRIORITY_HINT

 

 

Send comments about this topic to Microsoft

Show: