CurrentScheduler::ScheduleTask Method

Schedules a light-weight task within the scheduler associated with the calling context. The light-weight task will be placed in a schedule group determined by the runtime. The version that takes the parameter _Placement causes the task to be biased towards executing at the specified location.

static void __cdecl ScheduleTask(
   TaskProc _Proc,
   _Inout_opt_ void * _Data
);

static void __cdecl ScheduleTask(
   TaskProc _Proc,
   _Inout_opt_ void * _Data,
   location& _Placement
);

Parameters

• _Proc
  A pointer to the function to execute to perform the body of the light-weight task.

• _Data
  A void pointer to the data that will be passed as a parameter to the body of the task.

• _Placement
  A reference to a location where the light-weight task will be biased towards executing at.

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.

Requirements

Header: concrt.h

Namespace: concurrency

See Also

Reference

CurrentScheduler Class

ScheduleGroup Class

location Class

Concepts

Task Scheduler (Concurrency Runtime)