Edit

Share via


IUMSThreadProxy Structure

An abstraction for a thread of execution. If you want your scheduler to be granted user-mode schedulable (UMS) threads, set the value for the scheduler policy element SchedulerKind to UmsThreadDefault, and implement the IUMSScheduler interface. UMS threads are only supported on 64-bit operating systems with version Windows 7 and higher.

Syntax

struct IUMSThreadProxy : public IThreadProxy;

Members

Public Methods

Name Description
IUMSThreadProxy::EnterCriticalRegion Called in order to enter a critical region. When inside a critical region, the scheduler will not observe asynchronous blocking operations that happen during the region. This means that the scheduler will not be reentered for page faults, thread suspensions, kernel asynchronous procedure calls (APCs), and so forth, for a UMS thread.
IUMSThreadProxy::EnterHyperCriticalRegion Called in order to enter a hyper-critical region. When inside a hyper-critical region, the scheduler will not observe any blocking operations that happen during the region. This means the scheduler will not be reentered for blocking function calls, lock acquisition attempts which block, page faults, thread suspensions, kernel asynchronous procedure calls (APCs), and so forth, for a UMS thread.
IUMSThreadProxy::ExitCriticalRegion Called in order to exit a critical region.
IUMSThreadProxy::ExitHyperCriticalRegion Called in order to exit a hyper-critical region.
IUMSThreadProxy::GetCriticalRegionType Returns what kind of critical region the thread proxy is within. Because hyper-critical regions are a superset of critical regions, if code has entered a critical region and then a hyper-critical region, InsideHyperCriticalRegion will be returned.

Inheritance Hierarchy

IThreadProxy

IUMSThreadProxy

Requirements

Header: concrtrm.h

Namespace: concurrency

IUMSThreadProxy::EnterCriticalRegion Method

Called in order to enter a critical region. When inside a critical region, the scheduler will not observe asynchronous blocking operations that happen during the region. This means that the scheduler will not be reentered for page faults, thread suspensions, kernel asynchronous procedure calls (APCs), and so forth, for a UMS thread.

virtual int EnterCriticalRegion() = 0;

Return Value

The new depth of critical region. Critical regions are reentrant.

IUMSThreadProxy::EnterHyperCriticalRegion Method

Called in order to enter a hyper-critical region. When inside a hyper-critical region, the scheduler will not observe any blocking operations that happen during the region. This means the scheduler will not be reentered for blocking function calls, lock acquisition attempts which block, page faults, thread suspensions, kernel asynchronous procedure calls (APCs), and so forth, for a UMS thread.

virtual int EnterHyperCriticalRegion() = 0;

Return Value

The new depth of hyper-critical region. Hyper-critical regions are reentrant.

Remarks

The scheduler must be extraordinarily careful about what methods it calls and what locks it acquires in such regions. If code in such a region blocks on a lock that is held by something the scheduler is responsible for scheduling, deadlock may ensue.

IUMSThreadProxy::ExitCriticalRegion Method

Called in order to exit a critical region.

virtual int ExitCriticalRegion() = 0;

Return Value

The new depth of critical region. Critical regions are reentrant.

IUMSThreadProxy::ExitHyperCriticalRegion Method

Called in order to exit a hyper-critical region.

virtual int ExitHyperCriticalRegion() = 0;

Return Value

The new depth of hyper-critical region. Hyper-critical regions are reentrant.

IUMSThreadProxy::GetCriticalRegionType Method

Returns what kind of critical region the thread proxy is within. Because hyper-critical regions are a superset of critical regions, if code has entered a critical region and then a hyper-critical region, InsideHyperCriticalRegion will be returned.

virtual CriticalRegionType GetCriticalRegionType() const = 0;

Return Value

The type of critical region the thread proxy is within.

See also

concurrency Namespace
IUMSScheduler Structure