Fonction FltSetIoPriorityHintIntoFileObject (fltkernel.h)

Article
03/01/2024

La routine FltSetIoPriorityHintIntoFileObject est utilisée par un pilote de minifiltre pour définir les informations de priorité d’E/S dans un objet 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 avoir la valeur NULL.

[in] PriorityHint

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

Valeur retournée

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, il retourne une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :

Code de retour	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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows Vista.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure FltKernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL