Partager via


Fonction StorPortSetPriorityThread (storport.h)

StorPortSetPriorityThread définit la priorité d’exécution d’un thread créé par miniport.

Syntaxe

ULONG StorPortSetPriorityThread(
  [in] PVOID                HwDeviceExtension,
  [in] PVOID                ThreadContext,
  [in] STOR_THREAD_PRIORITY Priority
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel du miniport.

[in] ThreadContext

Pointeur vers le contexte de thread reçu lors d’un appel précédent à StorPortCreateSystemThread.

[in] Priority

Valeur d’énumération STOR_THREAD_PRIORITY qui spécifie la priorité de thread à définir.

Valeur retournée

StorPortSetPriorityThread retourne l’une des valeurs suivantes :

Code de retour Description
STOR_STATUS_SUCCESS La priorité de thread spécifiée a été définie avec succès.
STOR_STATUS_INVALID_IRQL Le niveau IRQL doit être égal à PASSIVE_LEVEL.
STOR_STATUS_INVALID_PARAMETER Un ou plusieurs des paramètres fournis ne sont pas valides.
STOR_STATUS_UNSUCCESSFUL Retourné pour d’autres raisons système internes.

Remarques

Un miniport peut appeler StorPortSetPriorityThread pour modifier la priorité du thread spécifié par ThreadContext.

Les threads, quelles que soient leurs priorités d’exécution respectives, sont exécutés à IRQL = PASSIVE_LEVEL. Pour plus d’informations, consultez Priorités des threads .

Un miniport doit spécifier une valeur de priorité de thread qui évite les inversions de priorité d’exécution. Pour plus d’informations, consultez Threads dédiés à l’appareil .

Configuration requise

Condition requise Valeur
Serveur minimal pris en charge Windows Server 2022
En-tête storport.h

Voir aussi

STOR_THREAD_PRIORITY

StorPortCreateSystemThread