ICLRTask::NeedsPriorityScheduling 方法
获取一个值,该值指示是否需要将正在切换的当前任务标记为高优先级以重新计划。
语法
HRESULT NeedsPriorityScheduling (
[out] BOOL *pbNeedsPriorityScheduling
);
参数
pbNeedsPriorityRescheduling
[out] 如果主机应尽快尝试重新计划当前任务实例,则为 true
,否则为 false
。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 NeedsPriorityRescheduling 。 |
HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
在任务即将被垃圾回收器收集的情况下,CLR 将 pbNeedsPriorityScheduling
的值设置为 true
,指示高优先级重新计划。 这样,主机可以快速重新计划任务,从而最大程度地降低垃圾回收延迟的可能性,使主机和运行时能够协作来节省内存资源。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用