Partager via

IHostTask ::SetPriority, méthode

Demande à l’hôte d’ajuster le niveau de priorité du thread pour la tâche représentée par l’instance IHostTask actuelle.

Syntaxe

HRESULT SetPriority (
    [in] int newPriority
);

Paramètres

newPriority [in] Entier qui représente la valeur de priorité de thread demandée pour la tâche représentée par l’instance actuelle IHostTask .

Valeur de retour

HRESULT Description
S_OK SetPriority retourné avec succès.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus, ou le CLR est dans un état dans lequel il ne peut pas exécuter le code managé ou traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant ne possède pas le verrou.
HOST_E_ABANDONED Un événement a été annulé pendant qu’un thread bloqué ou fibre attendait dessus.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Lorsqu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement retournent HOST_E_CLRNOTAVAILABLE.

Remarques

Les threads sont accordés au temps de traitement à l’aide d’un système de tourniquet qui est en partie basé sur le niveau de priorité d’un thread. SetPriority permet au CLR de définir ce niveau de priorité de thread pour la tâche actuelle. Les valeurs suivantes newPriority sont prises en charge.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

Le CLR appelle SetPriority lorsque la valeur du Thread.Priority clr est modifiée par le code utilisateur. Un hôte peut définir ses propres algorithmes pour l’attribution de priorité de thread et est libre d’ignorer cette requête.

Note

SetPriority ne signale pas si le niveau de priorité du thread a été modifié. Appelez IHostTask ::GetPriority pour déterminer la valeur du niveau de priorité de thread de la tâche.

Les valeurs de niveau de priorité de thread sont définies par la fonction Win32 SetThreadPriority . Pour plus d’informations sur la priorité des threads, consultez la documentation de la plateforme Windows.

Exigences

Plateformes : Consultez Configuration requise.

En-tête: MSCorEE.h

Bibliothèque: Inclus en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : Disponible depuis la version 2.0

Voir également

  • Last updated on