create_task, fonction

Crée un objet de la bibliothèque de modèles tâche .create_task peut vous être utilisé n'importe où aurait utilisé un constructeur de tâche.Il lui affecte principalement pour des raisons de commodité, car elle permet l'utilisation du mot clé d' auto lors de la création des tâches.

template<
   typename _Ty
>
auto create_task(
   _Ty_Param
) -> task<typename details::_TaskTypeFromParam<_Ty>::_Type>;

template<
   typename _Ty
>
auto create_task(
   _Ty_Param,
   cancellation_token _Token
) -> task<typename details::_TaskTypeFromParam<_Ty>::_Type>;

Paramètres

  • _Ty
    Le type du paramètre de la tâche doit être construite.

  • _Param
    Le paramètre dont la tâche doit être construite.Cela peut être une expression lambda ou exécuter l'objet, un objet d' task_completion_event , un autre objet d' task , ou une interface de Windows::Foundation::IAsyncInfo si vous utilisez des tâches dans votre application du style du métro.

  • _Token
    Le jeton d'annulation à associer à la tâche.Lorsque la source pour ce jeton est annulée, l'annulation est demandée sur la tâche.

Valeur de retour

Une nouvelle tâche de type T, qui est déduite d' _Param.

Notes

La première surcharge se comporte comme un constructeur de tâche qui prend un paramètre unique.

La deuxième surcharge associe le jeton d'annulation fourni de tâche de création récente.Si vous utilisez cette surcharge il ne vous permet pas à s'exécuter dans un autre objet d' task comme premier paramètre.

Le type de la tâche retournée est déduit du premier paramètre de la fonction.Si _Param est task_completion_event<T>, task<T>, ou un functor qui retourne le type T ou l' task<T>, le type de la tâche créée est task<T>.

Dans une application du style du métro, si _Param est ^ de Windows::Foundation::IAsyncOperation<T>de type ou de ^ de Windows::Foundation::IAsyncOperationWithProgress<T, P>, ou un functor qui retourne l'un ou l'autre de ces types, la tâche créée sera de type task<T>.Si _Param est de type Windows::Foundation::IAsyncAction^ ou ^ de Windows::Foundation::IAsyncActionWithProgress<p>, ou un functor qui retourne l'un ou l'autre de ces types, la tâche créée a le type task<void>.

Configuration requise

en-tête : ppltasks.h

Accès concurrentiel del'espace de noms :

Voir aussi

Référence

concurrency, espace de noms

classe de tâche

Concepts

Parallélisme des tâches (runtime d'accès concurrentiel)