FltSetIoPriorityHintIntoFileObject, fonction (fltkernel.h)

Article
02/06/2025

La routine FltSetIoPriorityHintIntoFileObject est utilisée par un pilote minifilter pour définir les informations de priorité d’E/S dans un objet de fichier.

Syntaxe

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

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier à modifier. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] PriorityHint

Valeur d’énumération IO_PRIORITY_HINT à définir pour l’objet de fichier pointé par FileObject.

Valeur de retour

Si la valeur de priorité d’E/S passée dans le paramètre PriorityHint est correctement appliquée à la structure FileObject, FltSetIoPriorityHintIntoFileObject retourne STATUS_SUCCESS. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER	La valeur du paramètre PriorityHint n’est pas valide. Il s’agit d’un code d’erreur.

Remarques

Cette routine est NONPAGED et peut être appelée à partir des chemins d’E/S de pagination.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	fltkernel.h (include FltKernel.h)
bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL