Поделиться через

Метод IHostTask::SetPriority

Запрашивает, что узел настраивает уровень приоритета потока для задачи, представленной текущим экземпляром IHostTask .

Синтаксис

HRESULT SetPriority (
    [in] int newPriority
);

Параметры

newPriority [in] Целое число, представляющее запрошенное значение приоритета потока для задачи, представленной текущим IHostTask экземпляром.

Возвращаемое значение

HRESULT Описание
S_OK SetPriority возвращается успешно.
HOST_E_CLRNOTAVAILABLE Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором он не может запустить управляемый код или обработать вызов успешно.
HOST_E_TIMEOUT Время ожидания вызова.
HOST_E_NOT_OWNER Вызывающий объект не владеет блокировкой.
HOST_E_ABANDONED Событие было отменено во время ожидания заблокированного потока или волокна.
E_FAIL Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не используется в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE.

Замечания

Потоки получают время обработки с помощью системы циклического перебора, которая частично основана на уровне приоритета потока. SetPriority позволяет среде CLR задать этот уровень приоритета потока для текущей задачи. Поддерживаются следующие newPriority значения.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

Среда CLR вызывается SetPriority при изменении значения пользовательского Thread.Priority кода. Узел может определять собственные алгоритмы назначения приоритета потока и не пропускать этот запрос.

Замечание

SetPriority Не сообщает, был ли изменен уровень приоритета потока. Вызовите IHostTask::GetPriority , чтобы определить значение уровня приоритета потока задачи.

Значения уровня приоритета потока определяются функцией Win32 SetThreadPriority . Дополнительные сведения о приоритете потока см. в документации по платформе Windows.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: MSCorEE.h

Библиотека: Включен как ресурс в MSCorEE.dll

Версии .NET Framework: Доступно с версии 2.0

См. также

  • Last updated on