FltApplyPriorityInfoThread, fonction (fltkernel.h)

Article
02/06/2025

La routine FltApplyPriorityInfoThread est utilisée par un pilote minifilter pour appliquer des informations de priorité à un thread.

Syntaxe

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

Paramètres

[in] InputPriorityInfo

Pointeur vers une structure IO_PRIORITY_INFO utilisée pour définir l’état de priorité du thread donné. Cette structure IO_PRIORITY_INFO doit avoir ses membres définis par une routine appropriée . Consultez la section Remarques suivante. Ce paramètre est obligatoire et ne peut pas être NULL.

[out, optional] OutputPriorityInfo

Un pointeur facultatif vers une structure de IO_PRIORITY_INFO utilisée pour recevoir l’état de priorité du thread avant le InputPriorityInfo informations de priorité est appliqué au thread par FltApplyPriorityInfoThread. Ce paramètre est facultatif et peut être NULL.

[in] Thread

Pointeur vers le thread dans lequel appliquer les informations de priorité InputPriorityInfo. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur de retour

Si les informations de priorité du thread, pointées par le paramètre InputPriorityInfo, sont correctement appliquées au thread donné, la routine FltApplyPriorityInfoThread retourne STATUS_SUCCESS. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER_1	La structure pointée par le paramètre InputPriorityInfo a été initialisée, mais une ou plusieurs de ses valeurs membres ne sont pas valides. Il s’agit d’un code d’erreur.

Remarques

Cette routine est disponible à partir de Windows Vista.

La routine FltApplyPriorityInfoThread définit la priorité d’E/S, la priorité de pagination et la priorité de thread du thread donné en fonction des valeurs membres de la structure IO_PRIORITY_INFO pointée par le paramètre InputPriorityInfo. Cela permet à un ensemble d’informations de priorité précédemment enregistrées, acquises par la routine FltRetrieveIoPriorityInfo ou FltApplyPriorityInfoThread routine, d’être appliquée à un thread.

Les valeurs d’origine du thread cible, avant que les valeurs InputPriorityInfo de priorité soient appliquées par la routine FltApplyPriorityInfoThread, peuvent être enregistrées si un pointeur OutputPriorityInfo valide est fourni. Notez que la structure pointée par le paramètre OutputPriorityInfo n’a pas besoin d’être initialisée.

Il est sûr de fournir le même pointeur vers une seule structure de IO_PRIORITY_INFO pour les paramètres InputPriorityInfo et OutputPriorityInfo.

Remarque Si les valeurs membres de la structure IO_PRIORITY_INFO pointées par le paramètre InputPriorityInfo n’ont pas été définies, vous devez définir ces membres avant d’appeler la routine FltApplyPriorityInfoThread, à l’aide de l’une des méthodes suivantes :

Appelez la routine FltRetrieveIoPriorityInfo.
Vérifiez que le paramètre InputPriorityInfo actuel était le paramètre OutputPriorityInfo dans un appel antérieur à la routine FltApplyPriorityInfoThread.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Universel
d’en-tête	fltkernel.h (include Fltkernel.h)
bibliothèque	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL