Lightweight Tasks

This document describes the role of lightweight tasks in the Concurrency Runtime. A lightweight task is a task that you schedule directly from a concurrency::Scheduler or concurrency::ScheduleGroup object. A lightweight task resembles the function that you provide to the Windows API CreateThread function. Therefore, lightweight tasks are useful when you adapt existing code to use the scheduling functionality of the Concurrency Runtime. The Concurrency Runtime itself uses lightweight tasks to schedule asynchronous agents and send messages between asynchronous message blocks.


The Concurrency Runtime provides a default scheduler, and therefore you are not required to create one in your application. Because the Task Scheduler helps you fine-tune the performance of your applications, we recommend that you start with the Parallel Patterns Library (PPL) or the Asynchronous Agents Library if you are new to the Concurrency Runtime.

Lightweight tasks carry less overhead than asynchronous agents and task groups. For example, the runtime does not inform you when a lightweight task finishes. In addition, the runtime does not catch or handle exceptions that are thrown from a lightweight task. For more information about exception handling and lightweight tasks, see Exception Handling.

For most tasks, we recommend that you use more robust functionality such as task groups and parallel algorithms because they let you more easily break complex tasks into more basic ones. For more information about task groups, see Task Parallelism. For more information about parallel algorithms, see Parallel Algorithms.

To create a lightweight task, call the concurrency::ScheduleGroup::ScheduleTask, concurrency::CurrentScheduler::ScheduleTask, or concurrency::Scheduler::ScheduleTask method. To wait for a lightweight task to finish, wait for the parent scheduler to shut down or use a synchronization mechanism such as a concurrency::event object.


For an example that demonstrates how to adapt existing code to use a lightweight task, see Walkthrough: Adapting Existing Code to Use Lightweight Tasks.

See also

Task Scheduler
Walkthrough: Adapting Existing Code to Use Lightweight Tasks