ICLRTask::NeedsPriorityScheduling-Methode
Ruft einen Wert ab, der angibt, ob der aktuelle Task, der ausgewechselt wird, als hohe Priorität für die Neuplanung gekennzeichnet werden muss.
Syntax
HRESULT NeedsPriorityScheduling (
[out] BOOL *pbNeedsPriorityScheduling
);
Parameter
pbNeedsPriorityRescheduling
[out] true
, wenn der Host versuchen soll, die aktuelle Taskinstanz so bald wie möglich neu zu planen, andernfalls false
.
Rückgabewert
HRESULT | BESCHREIBUNG |
---|---|
S_OK | NeedsPriorityRescheduling wurde erfolgreich zurückgegeben. |
HOST_E_CLRNOTAVAILABLE | Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
HOST_E_TIMEOUT | Timeout des Aufrufs. |
HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Bemerkungen
In Situationen, in denen der Task kurz davor liegt, vom Garbage Collector erfasst zu werden, legt die CLR den Wert von pbNeedsPriorityScheduling
bis true
fest, was die Neuplanung mit hoher Priorität angibt. Dies ermöglicht es dem Host, die Aufgabe schnell neu zu planen, wodurch das Potenzial für Verzögerungen bei der Garbage Collection minimiert wird, und der Host und die Runtime beim Einsparen von Arbeitsspeicher zusammenarbeiten können.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.