Bewerken

Delen via


FltSetIoPriorityHintIntoFileObject function (fltkernel.h)

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

See also

FLT_CALLBACK_DATA

FltApplyPriorityInfoThread

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoThread

IO_PRIORITY_HINT