CurrentScheduler::CreateScheduleGroup Method

Creates a new schedule group within the scheduler associated with the calling context.

_CRTIMP static ScheduleGroup * __cdecl CreateScheduleGroup();

Return Value

A pointer to the newly created schedule group. This ScheduleGroup object has an initial reference count placed on it.

Remarks

This method will result in the process' default scheduler being created and/or attached to the calling context if there is no scheduler currently associated with the calling context.

You must invoke the Release method on a schedule group when you are done scheduling work to it. The scheduler will destroy the schedule group when all work queued to it has completed.

Note that if you explicitly created this scheduler, you must release all references to schedule groups within it, before you release your reference on the scheduler, via detaching the current context from it.

Requirements

Header: concrt.h

Namespace: Concurrency

See Also

Reference

CurrentScheduler Class

ScheduleGroup Class

ScheduleGroup::Release Method

Concepts

Task Scheduler (Concurrency Runtime)