ICLRTask::NeedsPriorityScheduling, méthode

Article
08/10/2011

Obtient une valeur qui indique si la tâche en cours, qui est en cours de basculement, doit être marquée comme une priorité élevée pour une nouvelle planification.

HRESULT NeedsPriorityScheduling (
    [out] BOOL *pbNeedsPriorityScheduling
);

Paramètres

pbNeedsPriorityRescheduling
[out] true si l'hôte doit tenter de replanifier l'instance de tâche en cours dès que possible ; sinon false.

Valeur de retour

HRESULT	Description
S_OK	NeedsPriorityRescheduling a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de 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é alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et 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.

Notes

Dans les cas où la tâche est sur le point d'être collectée par le garbage collector, Le CLR définit la valeur de pbNeedsPriorityScheduling à true, pour indiquer une nouvelle planification prioritaire. Cela permet à l'hôte de replanifier la tâche rapidement, réduisant ainsi l'éventualité de retard du garbage collection et permettant à l'hôte et au runtime de coopérer pour conserver les ressources de la mémoire.