Compartilhar via


Método de structured_task_group::Run

Agenda uma tarefa sobre o structured_task_group objeto. O chamador gerencia a vida útil do task_handle objeto passado a _Task_handle parâmetro.

template<
   class _Function
>
void run(
   task_handle<_Function>& _Task_handle
);

Parâmetros

  • _Function
    O tipo de objeto de função que será chamado para executar o corpo da alça de tarefa.

  • _Task_handle
    Um identificador para o trabalho agendado. Observe que o chamador tem responsabilidade para a vida útil deste objeto. O tempo de execução continuará esperava live até o wait ou run_and_wait método foi chamado neste structured_task_group objeto.

Comentários

O runtime cria uma cópia da função de trabalho que você passa para este método. Qualquer alteração de estado que ocorrem em um objeto de função que você passa para este método não aparecerá em sua cópia desse objeto de função.

Se a structured_task_group destructs como resultado de pilha desenrolar a partir de uma exceção, você não precisará garantir que uma chamada foi feita qualquer do wait ou run_and_wait método. Nesse caso, o destruidor será adequadamente Cancelar e aguardar tarefa representada pela _Task_handle parâmetro para concluir.

Lança um invalid_multiple_scheduling exceção se a tarefa de lidar com determinado pelo _Task_handle parâmetro já foi agendado para um objeto de grupo de tarefas por meio do run método e não houve nenhuma chamada intermediárias a um a wait ou run_and_wait método em que grupo de tarefas.

Requisitos

Cabeçalho: PPL.h

Namespace: Simultaneidade

Consulte também

Referência

structured_task_group classe

Método de structured_task_group::wait

Conceitos

Paralelismo de tarefas (Runtime de simultaneidade)

Outros recursos

Método de structured_task_group::run_and_wait