Структура IExecutionContext

Интерфейс для контекста выполнения, который может выполняться на данном виртуальном процессоре и к которому может применяться совместное переключение контекста.

Синтаксис

struct IExecutionContext;

Участники

Открытые методы

Имя	Описание
IExecutionContext::D ispatch	Метод, вызываемый при запуске прокси-сервера потока для выполнения определенного контекста выполнения. Это должна быть основная рабочая подпрограмма для планировщика.
IExecutionContext::GetId	Возвращает уникальный идентификатор контекста выполнения.
IExecutionContext::GetProxy	Возвращает интерфейс прокси-сервера потока, выполняющего этот контекст.
IExecutionContext::GetScheduler	Возвращает интерфейс планировщику, к которому относится контекст выполнения.
IExecutionContext::SetProxy	Связывает прокси-сервер потока с этим контекстом выполнения. Связанный прокси-сервер потока вызывает этот метод прямо перед началом выполнения метода контекста Dispatch .

Замечания

Если вы реализуете пользовательский планировщик, который взаимодействует с диспетчером ресурсов среды выполнения параллелизма, необходимо реализовать IExecutionContext интерфейс. Потоки, созданные Resource Manager, выполняют работу от имени планировщика, выполняя IExecutionContext::Dispatch метод.

Иерархия наследования

IExecutionContext

Требования

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

Пространство имен: concurrency

Метод IExecutionContext::D ispatch

Метод, вызываемый при запуске прокси-сервера потока для выполнения определенного контекста выполнения. Это должна быть основная рабочая подпрограмма для планировщика.

virtual void Dispatch(_Inout_ DispatchState* pDispatchState) = 0;

Параметры

pDispatchState
Указатель на состояние, в котором выполняется отправка этого контекста выполнения. Дополнительные сведения о состоянии отправки см. в разделе DispatchState.

Метод IExecutionContext::GetId

Возвращает уникальный идентификатор контекста выполнения.

virtual unsigned int GetId() const = 0;

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

Уникальный целочисленный идентификатор.

Замечания

Для получения уникального идентификатора объекта, реализующего IExecutionContext интерфейс, следует использовать методGetExecutionContextId, прежде чем использовать интерфейс в качестве параметра для методов, предоставляемых Resource Manager. Ожидается, что при вызове функции возвращается тот же идентификатор GetId .

Идентификатор, полученный из другого источника, может привести к неопределенному поведению.

Метод IExecutionContext::GetProxy

Возвращает интерфейс прокси-сервера потока, выполняющего этот контекст.

virtual IThreadProxy* GetProxy() = 0;

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

Интерфейс IThreadProxy. Если прокси-сервер потока выполнения не был инициализирован с вызовом вызова SetProxy, функция должна вернуться NULL.

Замечания

Resource Manager вызовет SetProxy метод в контексте выполнения с IThreadProxy интерфейсом в качестве параметра перед вводом Dispatch метода в контексте. Ожидается, что этот аргумент хранится и возвращается при вызовах GetProxy().

Метод IExecutionContext::GetScheduler

Возвращает интерфейс планировщику, к которому относится контекст выполнения.

virtual IScheduler* GetScheduler() = 0;

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

Интерфейс IScheduler.

Замечания

Необходимо инициализировать контекст выполнения с допустимым IScheduler интерфейсом, прежде чем использовать его в качестве параметра для методов, предоставляемых Resource Manager.

Метод IExecutionContext::SetProxy

Связывает прокси-сервер потока с этим контекстом выполнения. Связанный прокси-сервер потока вызывает этот метод прямо перед началом выполнения метода контекста Dispatch .

virtual void SetProxy(_Inout_ IThreadProxy* pThreadProxy) = 0;

Параметры

pThreadProxy
Интерфейс прокси-сервера потока, который требуется ввести Dispatch метод в этом контексте выполнения.

Замечания

Ожидается, что вы сохраните параметр pThreadProxy и вернете его при вызове GetProxy метода. Resource Manager гарантирует, что прокси-сервер потока, связанный с контекстом выполнения, не изменится, пока прокси-сервер потока выполняет Dispatch метод.

См. также

Пространство имен concurrency
Структура IScheduler
Структура IThreadProxy