ICLRTask::NeedsPriorityScheduling, méthode
Obtient une valeur qui indique si la tâche actuelle, qui est en cours de basculement, doit être marquée comme prioritaire pour une replanification.
Syntaxe
HRESULT NeedsPriorityScheduling (
[out] BOOL *pbNeedsPriorityScheduling
);
Paramètres
pbNeedsPriorityRescheduling
[out] true
, si l’hôte doit tenter de replanifier l’instance de tâche actuelle dès que possible ; sinon, false
.
Valeur de retour
HRESULT | Description |
---|---|
S_OK | NeedsPriorityRescheduling retourné. |
HOST_E_CLRNOTAVAILABLE | Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès. |
HOST_E_TIMEOUT | L’appel a expiré. |
HOST_E_NOT_OWNER | L’appelant n’est pas propriétaire du verrou. |
HOST_E_ABANDONED | Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait. |
E_FAIL | Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
Dans les situations où la tâche est sur le point d’être proche d’être collectée par le récupérateur de mémoire, le CLR définit la valeur de pbNeedsPriorityScheduling
sur true
pour indiquer que la replanification est prioritaire. L’hôte peut ainsi replanifier rapidement la tâche, ce qui limite les risques de retard en termes de nettoyage de la mémoire et permet à l'hôte et au runtime de coopérer pour conserver les ressources mémoire.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MsCorEE.dll
Versions de .NET Framework : Disponible depuis la version 2.0