Compartilhar via


Classe task_handle

A classe de task_handle representa um item de trabalho paralelo individual. Encapsula as instruções e os dados necessários para executar um bico de trabalho.

template<
   typename _Function
>
class task_handle : public ::Concurrency::details::_UnrealizedChore;

Parâmetros

  • _Function
    O tipo de objeto de função que será invocado para executar o trabalho representada pelo objeto de task_handle .

Membros

Construtores Públicos

Nome

Descrição

Construtor task_handle::task_handle

Cria um novo objeto de task_handle . O trabalho da tarefa é executado chamando a função especificada como um parâmetro para o construtor.

Destruidor task_handle::~task_handle

Destrói o objeto task_handle.

Operadores Públicos

Nome

Descrição

Operador task_handle::operator()

O operador de chamada de função que o tempo de execução chama para executar o trabalho do identificador da tarefa.

Comentários

os objetos detask_handle podem ser usados em conjunto com structured_task_group ou mais um objeto de task_group geral, para decompor o trabalho em tarefas paralelas. Para obter mais informações, consulte Paralelismo de tarefa (tempo de execução de simultaneidade).

Observe que o criador de um objeto de task_handle é responsável por manter o tempo de vida do objeto criado de task_handle até que seja necessário já não no tempo de execução de simultaneidade. Normalmente, isso significa que o objeto de task_handle não deve destruct ou até wait ou método de run_and_wait de task_group ou structured_task_group a que foi enfileirado esteve chamado.

os objetos detask_handle são usados em conjunto com lambdas C++. Como você não souber o tipo de lambda true, a função de make_task normalmente é usado para criar um objeto de task_handle .

O tempo de execução cria uma cópia da função de trabalho que você passa a um objeto de task_handle . Em virtude disso, qualquer alteração de estado que ocorrem em um objeto de função que você transmita a um objeto de task_handle não aparecerão em sua cópia do objeto de função.

Hierarquia de Herança

task_handle

Requisitos

Cabeçalho: ppl.h

Namespace: simultaneidade

Consulte também

Referência

Namespace Concurrency

Classe task_group

Classe structured_task_group

Função make_task

Método task_group::run

Método task_group::wait

Método task_group::run_and_wait

Método structured_task_group::run

Método structured_task_group::wait

Método structured_task_group::run_and_wait