IExecutionContext Structure
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
An interface to an execution context which can run on a given virtual processor and be cooperatively context switched.
Syntax
struct IExecutionContext;
Members
Public Methods
| Name | Description |
|---|---|
| IExecutionContext::Dispatch Method | The method that is called when a thread proxy starts executing a particular execution context. This should be the main worker routine for your scheduler. |
| IExecutionContext::GetId Method | Returns a unique identifier for the execution context. |
| IExecutionContext::GetProxy Method | Returns an interface to the thread proxy that is executing this context. |
| IExecutionContext::GetScheduler Method | Returns an interface to the scheduler this execution context belongs to. |
| IExecutionContext::SetProxy Method | Associates a thread proxy with this execution context. The associated thread proxy invokes this method right before it starts executing the context's Dispatch method. |
Remarks
If you are implementing a custom scheduler that interfaces with the Concurrency Runtime's Resource Manager, you will need to implement the IExecutionContext interface. The threads created by the Resource Manager perform work on behalf of your scheduler by executing the IExecutionContext::Dispatch method.
Inheritance Hierarchy
IExecutionContext
Requirements
Header: concrtrm.h
Namespace: concurrency
IExecutionContext::Dispatch Method
The method that is called when a thread proxy starts executing a particular execution context. This should be the main worker routine for your scheduler.
virtual void Dispatch(_Inout_ DispatchState* pDispatchState) = 0;
Parameters
pDispatchState
A pointer to the state under which this execution context is being dispatched. For more information on dispatch state, see DispatchState.
IExecutionContext::GetId Method
Returns a unique identifier for the execution context.
virtual unsigned int GetId() const = 0;
Return Value
A unique integer identifier.
Remarks
You should use the method GetExecutionContextId to obtain a unique identifier for the object that implements the IExecutionContext interface, before you use the interface as a parameter to methods supplied by the Resource Manager. You are expected to return the same identifier when the GetId function is invoked.
An identifier obtained from a different source could result in undefined behavior.
IExecutionContext::GetProxy Method
Returns an interface to the thread proxy that is executing this context.
virtual IThreadProxy* GetProxy() = 0;
Return Value
An IThreadProxy interface. If the execution context's thread proxy has not been initialized with a call to SetProxy, the function must return NULL.
Remarks
The Resource Manager will invoke the SetProxy method on an execution context, with an IThreadProxy interface as a parameter, prior to entering the Dispatch method on the on the context. You are expected to store this argument and return it on calls to GetProxy().
IExecutionContext::GetScheduler Method
Returns an interface to the scheduler this execution context belongs to.
virtual IScheduler* GetScheduler() = 0;
Return Value
An IScheduler interface.
Remarks
You are required to initialize the execution context with a valid IScheduler interface before you use it as a parameter to methods supplied by the Resource Manager.
IExecutionContext::SetProxy Method
Associates a thread proxy with this execution context. The associated thread proxy invokes this method right before it starts executing the context's Dispatch method.
virtual void SetProxy(_Inout_ IThreadProxy* pThreadProxy) = 0;
Parameters
pThreadProxy
An interface to the thread proxy that is about to enter the Dispatch method on this execution context.
Remarks
You are expected to save the parameter pThreadProxy and return it on a call to the GetProxy method. The Resource Manager guarantees that the thread proxy associated with the execution context will not change while the thread proxy is executing the Dispatch method.
See Also
concurrency Namespace
IScheduler Structure
IThreadProxy Structure