Интерфейс ICLRTask

Предоставляет методы, позволяющие ведущему приложению выполнять запросы среды CLR или уведомлять среду CLR о связанной задаче.

Методы

Метод	Описание
Метод Abort	Запрашивает, чтобы среда CLR прервала задачу, представленную текущим ICLRTask экземпляром.
Метод ExitTask	Уведомляет среду CLR о завершении задачи, связанной с текущим ICLRTask экземпляром, и пытается корректно завершить задачу.
Метод GetMemStats	Получает статистические сведения об использовании ресурсов памяти задачей, представленной текущим ICLRTask экземпляром.
Метод LocksHeld	Возвращает количество блокировок, удерживаемых в данный момент в задаче.
Метод NeedsPriorityScheduling	Возвращает значение, указывающее, должен ли узел назначать высокий приоритет для перепланирования задачи, представленной текущим ICLRTask экземпляром.
Метод Reset	Сообщает среде CLR о том, что узел завершил задачу, и позволяет среде CLR повторно использовать текущий ICLRTask экземпляр для представления другой задачи.
Метод RudeAbort	Вызывает немедленное прерывание среды CLR задачи, представленной текущим ICLRTask экземпляром, без гарантии выполнения методов завершения.
Метод SetTaskIdentifier	Задает уникальный идентификатор задачи, представленной текущим ICLRTask экземпляром, для использования в отладке.
Метод SwitchIn	Уведомляет среду CLR о том, что задача, представленная текущим ICLRTask экземпляром, находится в работоспособном состоянии.
Метод SwitchOut	Уведомляет среду CLR о том, что задача, представленная текущим ICLRTask экземпляром, больше не находится в работоспособном состоянии.
Метод YieldTask	Запрашивает, чтобы среда CLR была доступна для других задач. Среда CLR не гарантирует, что задача будет помещена в состояние, в котором она может дать время обработки.

Комментарии

— ICLRTask это представление задачи для среды CLR. В любой момент выполнения кода задачу можно описать как выполняющуюся или ожидающую выполнения. Узел вызывает ICLRTask::SwitchIn метод , чтобы уведомить среду CLR о том, что задача, представленная текущим ICLRTask экземпляром, теперь находится в работоспособном состоянии. После вызова ICLRTask::SwitchInузел может запланировать задачу в любом потоке операционной системы, за исключением случаев, когда среде выполнения требуется сопоставление потоков, как указано в вызовах методов IHostTaskManager::BeginThreadAffinity и IHostTaskManager::EndThreadAffinity . Через некоторое время операционная система может решить удалить задачу из потока и поместить ее в нерабочем состоянии. Например, это может произойти всякий раз, когда задача блокирует примитивы синхронизации или ожидает завершения операций ввода-вывода. Узел вызывает SwitchOut , чтобы уведомить среду CLR о том, что задача, представленная текущим ICLRTask экземпляром, больше не находится в работоспособном состоянии.

Задача обычно завершается в конце выполнения кода. В это время узел вызывает ICLRTask::ExitTask , чтобы уничтожить связанный ICLRTaskобъект . Однако задачи также можно перезаработать с помощью вызова ICLRTask::Reset, который позволяет ICLRTask повторно использовать экземпляр . Такой подход предотвращает многократное создание и уничтожение экземпляров.

Требования

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

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

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

версии платформа .NET Framework: доступно с версии 2.0.

См. также раздел

• Интерфейс ICLRTaskManager
• Интерфейс IHostTask
• Интерфейс IHostTaskManager
• Интерфейсы размещения
• Интерфейс ICLRTask2