Namespace Concurrency
O namespace Concurrency oferece classes e funções que permitem que você acesse o Runtime de simultaneidade, uma estrutura de programação simultânea para C++. Para obter mais informações, consulte Runtime de Simultaneidade.
Sintaxe
namespace concurrency;
Membros
Typedefs
| Nome | Descrição |
|---|---|
runtime_object_identity |
Cada instância de mensagem tem uma identidade que a segue à medida que é clonada e passada entre componentes de mensagens. Esse não pode ser o endereço do objeto de mensagem. |
task_status |
Um tipo que representa o estado terminal de uma tarefa. Os valores válidos são completed e canceled. |
TaskProc |
Uma abstração elementar para uma tarefa, definida como void (__cdecl * TaskProc)(void *). Um TaskProc é chamado para invocar o corpo de uma tarefa. |
TaskProc_t |
Uma abstração elementar para uma tarefa, definida como void (__cdecl * TaskProc_t)(void *). Um TaskProc é chamado para invocar o corpo de uma tarefa. |
Classes
| Nome | Descrição |
|---|---|
| Classe affinity_partitioner | A classe affinity_partitioner é semelhante à classestatic_partitioner, mas melhora a afinidade de cache por sua escolha de subintervalos de mapeamento para threads de trabalho. Ela pode melhorar significativamente o desempenho quando um loop é executado novamente no mesmo conjunto de dados e os dados se ajustam ao cache. Observe que o mesmo objeto affinity_partitioner deve ser usado com iterações subsequentes de um loop paralelo executado em um determinado conjunto de dados, para se beneficiar da localidade dos dados. |
| Classe agent | Uma classe destinada a ser usada como uma classe base para todos os agentes independentes. Ele é usado para ocultar o estado de outros agentes e interagir usando a passagem de mensagens. |
| Classe auto_partitioner | A classe auto_partitioner representa o método padrão que parallel_for, parallel_for_each e parallel_transform usa para particionar o intervalo em que itera. Esse método de particionamento emprega o roubo de intervalo para balanceamento de carga, bem como o cancelamento por iteração. |
| Classe bad_target | Essa classe descreve uma exceção gerada quando um bloco de mensagens recebe um ponteiro para um destino inválido para a operação que está sendo executada. |
| Classe call | Um bloco de mensagens call é um target_block de várias fontes ordenado que invoca uma função especificada ao receber uma mensagem. |
| Classe cancellation_token | A classe cancellation_token representa a capacidade de determinar se alguma operação foi solicitada para cancelar. Um determinado token pode ser associado a um task_group, structured_task_group ou task para fornecer cancelamento implícito. Ele também pode ser sondado para cancelamento ou ter um retorno de chamada registrado para se e quando o cancellation_token_source associado for cancelado. |
| Classe cancellation_token_registration | A classe cancellation_token_registration representa uma notificação de retorno de chamada de um cancellation_token. Quando o método register em um cancellation_token é usado para receber notificação de quando o cancelamento ocorre, um objeto cancellation_token_registration é retornado como um identificador para o retorno de chamada para que o autor da chamada possa solicitar um retorno de chamada específico não seja mais feito por meio do uso do método deregister. |
| Classe cancellation_token_source | A classe cancellation_token_source representa a capacidade de cancelar alguma operação cancelável. |
| Classe choice | Um bloco de mensagens choice é um bloco de destino único de várias fontes que representa uma interação de fluxo de controle com um conjunto de fontes. O bloco de escolha aguardará que qualquer uma das várias fontes produza uma mensagem e propagará o índice da origem que produziu a mensagem. |
| Classe combinable | O objeto combinable<T> destina-se a fornecer cópias de dados privados de thread para executar subcomputações locais de thread sem bloqueio durante algoritmos paralelos. No final da operação paralela, as subcomputações privadas de thread podem ser mescladas em um resultado final. Essa classe pode ser usada em vez de uma variável compartilhada e poderá resultar em uma melhoria de desempenho se, de outra forma, houver muita contenção nessa variável compartilhada. |
| Classe concurrent_priority_queue | A classe concurrent_priority_queue é um contêiner que permite que vários threads enviem itens por push e removam o item mais recente da pilha ao mesmo tempo. Os itens são exibidos na ordem de prioridade em que a prioridade é determinada por um functor fornecido como um argumento de modelo. |
| Classe concurrent_queue | A classe concurrent_queue é uma classe de contêiner de sequência que permite acesso primeiro a entrar, primeiro a sair a seus elementos. Ela habilita um conjunto limitado de operações de segurança de simultaneidade, como push e try_pop. |
| Classe concurrent_unordered_map | A classe concurrent_unordered_map é um contêiner seguro para simultaneidade que controla uma sequência de comprimento variável de elementos do tipo std::pair<const K, _Element_type>. A sequência é representada de uma forma que permite o acréscimo seguro para simultaneidade, o acesso a elementos, o acesso a iteradores e operações de passagem de iteradores. |
| Classe concurrent_unordered_multimap | A classe concurrent_unordered_multimap é um contêiner seguro para simultaneidade que controla uma sequência de comprimento variável de elementos do tipo std::pair<const K, _Element_type>. A sequência é representada de uma forma que permite o acréscimo seguro para simultaneidade, o acesso a elementos, o acesso a iteradores e operações de passagem de iteradores. |
| Classe concurrent_unordered_multiset | A classe concurrent_unordered_multiset é um contêiner seguro para simultaneidade que controla uma sequência de vários comprimentos de elementos do tipo K. A sequência é representada de uma forma que permite acréscimo seguro para simultaneidade, acesso a elementos, acesso de iterador e operações de passagem do iterador. |
| Classe concurrent_unordered_set | A classe concurrent_unordered_set é um contêiner seguro para simultaneidade que controla uma sequência de vários comprimentos de elementos do tipo K. A sequência é representada de uma forma que permite acréscimo seguro para simultaneidade, acesso a elementos, acesso de iterador e operações de passagem do iterador. |
| Classe concurrent_vector | A classe concurrent_vector é uma classe de contêiner de sequência que permite acesso aleatório a qualquer elemento. Ela habilita o acréscimo concurrency-safe, o acesso ao elemento, o acesso ao iterador e as operações de passagem do iterador. |
| Classe de contexto | Representa uma abstração para um contexto de execução. |
| Classe context_self_unblock | Essa classe descreve uma exceção gerada quando o método Unblock de um objeto Context é chamado do mesmo contexto. Isso indicaria uma tentativa de um determinado contexto de se desbloquear. |
| Classe context_unblock_unbalanced | Essa classe descreve uma exceção gerada quando chamadas aos métodos Block e Unblock de um objeto Context não são emparelhadas corretamente. |
| Classe critical_section | Um mutex não reentrante que está explicitamente ciente do Runtime de Simultaneidade. |
| Classe CurrentScheduler | Representa uma abstração para o agendador atual associado ao contexto de chamada. |
| Classe default_scheduler_exists | Essa classe descreve uma exceção gerada quando o método Scheduler::SetDefaultSchedulerPolicy é chamado quando um agendador padrão já existe dentro do processo. |
| Classe event | Um evento de redefinição manual que está explicitamente ciente do Runtime de Simultaneidade. |
| Classe improper_lock | Essa classe descreve uma exceção gerada quando um bloqueio é adquirido incorretamente. |
| Classe improper_scheduler_attach | Essa classe descreve uma exceção gerada quando o método Attach é chamado em um objeto Scheduler que já está anexado ao contexto atual. |
| Classe improper_scheduler_detach | Essa classe descreve uma exceção gerada quando o método CurrentScheduler::Detach é chamado em um contexto que não foi anexado a nenhum agendador usando o método Attach de um objeto Scheduler. |
| Classe improper_scheduler_reference | Essa classe descreve uma exceção gerada quando o método Reference é chamado em um objeto Scheduler que está sendo desligado, de um contexto que não faz parte desse agendador. |
| Classe invalid_link_target | Essa classe descreve uma exceção gerada quando o método link_target de um bloco de mensagens é chamado e o bloco de mensagens não consegue se vincular ao destino. Isso pode ser o resultado de exceder o número de links permitidos ao bloco de mensagens ou de tentar vincular um destino específico duas vezes à mesma origem. |
| Classe invalid_multiple_scheduling | Essa classe descreve uma exceção gerada quando um objeto task_handle é agendado várias vezes usando o método run de um objeto task_group ou structured_task_group sem uma chamada intermediária para os métodos wait ou run_and_wait. |
| Classe invalid_operation | Essa classe descreve uma exceção gerada quando uma operação inválida é executada que não é descrita com mais precisão por outro tipo de exceção gerado pelo Runtime de Simultaneidade. |
| Classe invalid_oversubscribe_operation | Essa classe descreve uma exceção gerada quando o método Context::Oversubscribe é chamado com o parâmetro _BeginOversubscription definido como false sem uma chamada anterior ao método Context::Oversubscribe com o parâmetro _BeginOversubscription definido como true. |
| Classe invalid_scheduler_policy_key | Essa classe descreve uma exceção gerada quando uma chave inválida ou desconhecida é passada para um construtor de objeto SchedulerPolicy ou o método SetPolicyValue de um objeto SchedulerPolicy é passado por uma chave que deve ser alterada usando outros meios, como o método SetConcurrencyLimits. |
| Classe invalid_scheduler_policy_thread_specification | Essa classe descreve uma exceção gerada quando é feita uma tentativa de definir os limites de simultaneidade de um objeto SchedulerPolicy de modo que o valor da chave MinConcurrency seja menor que o valor da chave MaxConcurrency. |
| Classe invalid_scheduler_policy_value | Essa classe descreve uma exceção gerada quando uma chave de política de um objeto SchedulerPolicy é definida como um valor inválido para essa chave. |
| Classe ISource | A classe ISource é a interface para todos os blocos de origem. Blocos de origem propagam mensagens para blocos ITarget. |
| Classe ITarget | A classe ITarget é a interface para todos os blocos de destino. Os blocos de destino consomem mensagens oferecidas a eles por blocos ISource. |
| Classe join | Um bloco de mensagens join é um propagator_block único, de várias origens, ordenado que combina mensagens de tipo T de cada uma de suas fontes. |
| Classe location | Uma abstração de um local físico no hardware. |
| Classe message | O envelope de mensagem básico que contém a carga de dados sendo passada entre blocos de mensagens. |
| Classe message_not_found | Essa classe descreve uma exceção gerada quando um bloco de mensagens não consegue encontrar uma mensagem solicitada. |
| Classe message_processor | A classe message_processor é a classe base abstrata para processamento de objetos message. Não há garantia sobre a ordenação das mensagens. |
| Classe missing_wait | Essa classe descreve uma exceção gerada quando ainda há tarefas agendadas para um objeto task_group ou structured_task_group no momento em que o destruidor do objeto é executado. Essa exceção nunca será gerada se o destruidor for atingido devido a um desenrolamento de pilha como resultado de uma exceção. |
| Classe multi_link_registry | O objeto multi_link_registry é um network_link_registry que gerencia vários blocos de origem ou vários blocos de destino. |
| Classe multitype_join | Um bloco de mensagens multitype_join é um bloco de mensagens de várias origens e de destino único que combina mensagens de diferentes tipos de cada uma de suas fontes e oferece uma tupla das mensagens combinadas aos seus destinos. |
| Classe nested_scheduler_missing_detach | Essa classe descreve uma exceção gerada quando o Runtime de Simultaneidade detecta que você esqueceu de chamar o método CurrentScheduler::Detach em um contexto anexado a um segundo agendador usando o método Attach do objeto Scheduler. |
| Classe network_link_registry | A classe base abstrata network_link_registry gerencia os links entre os blocos de origem e de destino. |
| Classe operation_timed_out | Essa classe descreve uma exceção gerada quando uma operação atingiu o tempo limite. |
| Classe ordered_message_processor | Uma ordered_message_processor é um message_processor que permite que blocos de mensagens processem mensagens na ordem em que foram recebidas. |
| Classe overwrite_buffer | Um bloco de mensagens overwrite_buffer é um propagator_block multidestino, de várias origens e ordenado capaz de armazenar uma mensagem por vez. Novas mensagens substituem as mantidas anteriormente. |
| Classe progress_reporter | A classe de relator de andamento permite criar relatórios de notificações de andamento de um tipo específico. Cada objeto progress_reporter está associado a uma determinada ação ou operação assíncrona. |
| Classe propagator_block | A classe propagator_block é uma classe base abstrata para blocos de mensagens que são uma origem e um destino. Ela combina a funcionalidade das classes source_block e target_block. |
| Classe reader_writer_lock | Um bloqueio de leitor-gravador baseado em fila de preferência de gravador com a rotação local apenas. O bloqueio concede acesso FIFO (first in - first out, primeiro a entrar, primeiro a sair) a gravadores e priva os leitores de recursos sob uma carga contínua de gravadores. |
| Classe ScheduleGroup | Representa uma abstração de um grupo agendado. Os grupos agendados organizam um conjunto de trabalhos relacionados que se beneficiam do agendamento conjunto, seja temporalmente (por meio da execução de outra tarefa no mesmo grupo antes de passar para o seguinte) ou espacialmente (por meio da execução de vários itens do mesmo grupo no mesmo nó NUMA ou soquete físico). |
| Classe Scheduler | Representa uma abstração para um agendador de Runtime de Simultaneidade. |
| Classe scheduler_not_attached | Essa classe descreve uma exceção gerada quando uma operação é executada, o que exige que um agendador seja anexado ao contexto atual e um não seja. |
| Classe scheduler_resource_allocation_error | Essa classe descreve uma exceção gerada devido a uma falha na aquisição de um recurso crítico no Runtime de Simultaneidade. |
| Classe scheduler_worker_creation_error | Essa classe descreve uma exceção gerada devido a uma falha na criação de um contexto de execução de trabalho no Runtime de Simultaneidade. |
| Classe SchedulerPolicy | A classe SchedulerPolicy contém um conjunto de pares de chave/valor, um para cada elemento de política, que controlam o comportamento de uma instância do agendador. |
| Classe simple_partitioner | A classe simple_partitioner representa um particionamento estático do intervalo iterado por parallel_for. O particionador divide o intervalo em partes de forma que cada parte tenha pelo menos o número de iterações especificado pelo tamanho da parte. |
| Classe single_assignment | Um bloco de mensagens single_assignment é um propagator_block de vários destinos, de várias origens e ordenado capaz de armazenar um message único, de gravação única. |
| Classe single_link_registry | O objeto single_link_registry é um network_link_registry que gerencia apenas um bloco de origem ou destino. |
| Classe source_block | A classe source_block é uma classe base abstrata para blocos somente de origem. A classe fornece funcionalidade básica de gerenciamento de link, bem como verificações de erros comuns. |
| Classe source_link_manager | O objeto source_link_manager gerencia links de rede de bloqueio de mensagens para blocos ISource. |
| Classe static_partitioner | A classe static_partitioner representa um particionamento estático do intervalo iterado por parallel_for. O particionador divide o intervalo em quantas partes houver trabalhados disponíveis para o agendador subjacente. |
| Classe structured_task_group | A classe structured_task_group representa uma coleção altamente estruturada de trabalho paralelo. Você pode enfileirar tarefas paralelas individuais para um structured_task_group usando objetos task_handle e aguardar a conclusão deles ou cancelar o grupo de tarefas antes que eles terminem de executar, o que anulará todas as tarefas que não iniciaram a execução. |
| Classe target_block | A classe target_block é uma classe base abstrata que fornece funcionalidade básica de gerenciamento de link e verificação de erros para blocos apenas de destino. |
| Classe task (Runtime de Simultaneidade) | A classe task da Biblioteca de Padrões Paralelos (PPL). O objeto task representa o trabalho que pode ser executado de forma assíncrona e simultaneamente com outras tarefas e o trabalho paralelo produzido por algoritmos paralelos no Runtime de simultaneidade. Produz um resultado de tipo _ResultType após uma conclusão bem-sucedida. Tarefas do tipo task<void> não produzem resultados. Uma tarefa pode ser aguardada e cancelada independentemente de outras tarefas. Ela também pode ser composta por outras tarefas usando continuations(then) e os padrões join(when_all) e choice(when_any). |
| Classe task_canceled | Essa classe descreve uma exceção gerada pela camada de tarefas PPL para forçar o cancelamento da tarefa atual. Ele também é gerado pelo get() método na tarefa, para uma tarefa cancelada. |
| Classe task_completion_event | A classe task_completion_event permite atrasar a execução de uma tarefa até que uma condição seja atendida, ou iniciar uma tarefa em resposta a um evento externo. |
| Classe task_continuation_context | A classe task_continuation_context permite que você especifique onde gostaria que uma continuação fosse executada. Isso será útil somente para o uso dessa classe por meio de um aplicativo UWP. Para aplicativos que não são do Windows Runtime, o contexto de execução da continuação da tarefa é determinado pelo tempo de execução, e não é configurável. |
| Classe task_group | A classe task_group representa uma coleção de trabalhos paralelos que podem ser aguardados ou cancelados. |
| Classe task_handle | A classe task_handle representa um item de trabalho paralelo individual. Ela encapsula as instruções e os dados necessários para executar um trabalho. |
| Classe task_options (Runtime de Simultaneidade) | Representa as opções permitidas para criar uma tarefa |
| Classe timer | Um bloco de mensagens timer é um source_block de destino único capaz de enviar uma mensagem para seu destino após um período especificado ter se passado ou a intervalos específicos. |
| Classe transformer | Um bloco de mensagens transformer é um propagator_block de destino único, de várias fontes e ordenado que pode aceitar mensagens de um tipo, sendo capaz de armazenar um número não associado de mensagens de um tipo diferente. |
| Classe unbounded_buffer | Um bloco de mensagens unbounded_buffer é um propagator_block multidestino, de várias origens e ordenado e é capaz de armazenar um número não associado por vez. |
| Classe unsupported_os | Essa classe descreve uma exceção gerada quando um sistema operacional sem suporte é usado. |
Estruturas
| Nome | Descrição |
|---|---|
| Estrutura DispatchState | A estrutura DispatchState é usada para transferir o estado para o método IExecutionContext::Dispatch. Ela descreve as circunstâncias sob as quais o método Dispatch é invocado em uma interface IExecutionContext. |
| Estrutura IExecutionContext | Uma interface para um contexto de execução que pode ser executada em um determinado processador virtual e ser alternada de contexto cooperativamente. |
| Estrutura IExecutionResource | Uma abstração para um thread de hardware. |
| Estrutura IResourceManager | Uma interface para o Resource Manager do Runtime de Simultaneidade. Essa é a interface pela qual os agendadores se comunicam com o Resource Manager. |
| Estrutura IScheduler | Uma interface para uma abstração de um agendador de trabalho. O Resource Manager do Runtime de Simultaneidade usa essa interface para se comunicar com agendadores de trabalho. |
| Estrutura ISchedulerProxy | A interface pela qual os agendadores se comunicam com o Runtime de Simultaneidade do Resource Manager para negociar a alocação de recursos. |
| Estrutura IThreadProxy | Uma abstração para um thread de execução. Dependendo da chave de política SchedulerType do agendador que você criar, o Resource Manager concederá a você um proxy de thread com o suporte de um thread do Win32 regular ou um thread UMS (agendável em modo de usuário). Os threads UMS têm suporte em sistemas operacionais de 64 bits com a versão Windows 7 e superior. |
| Estrutura ITopologyExecutionResource | Uma interface para um recurso de execução conforme definido pelo Resource Manager. |
| Estrutura ITopologyNode | Uma interface para um nó de topologia conforme definido pelo Resource Manager. Um nó contém um ou mais recursos de execução. |
| Estrutura IUMSCompletionList | Representa um item da lista de conclusão UMS. Quando um thread UMS é bloqueado, o contexto de agendamento designado pelo agendador é enviado para tomar uma decisão do que agendar na raiz do processador virtual subjacente enquanto o thread original é bloqueado. Quando o thread original é desbloqueado, o sistema operacional o enfileira na lista de conclusão que é acessível por meio dessa interface. O agendador pode consultar a lista de conclusão no contexto de agendamento designado ou em qualquer outro local em que pesquisa para trabalho. |
| Estrutura IUMSScheduler | Uma interface para uma abstração de um agendador de trabalho que deseja que o Resource Manager do Runtime de Simultaneidade entregue a ela threads UMS (programáveis no modo de usuário). O Resource Manager usa essa interface para se comunicar com agendadores de thread UMS. A interface IUMSScheduler herda da interface IScheduler . |
| Estrutura IUMSThreadProxy | Uma abstração para um thread de execução. Se você quiser que o agendador tenha threads agendados (UMS) no modo de usuário, defina o valor para o elemento de política do agendador SchedulerKind para UmsThreadDefault e implemente a interface IUMSScheduler. Os threads UMS têm suporte apenas em sistemas operacionais de 64 bits com a versão Windows 7 e superior. |
| Estrutura IUMSUnblockNotification | Representa uma notificação do Resource Manager de que um proxy de thread que bloqueou e disparou um retorno ao contexto de agendamento designado do agendador foi desbloqueado e está pronto para ser agendado. Essa interface é inválida quando o contexto de execução associado do proxy de thread, retornado do método GetContext, é reagendado. |
| Estrutura IVirtualProcessorRoot | Uma abstração para um thread de hardware no qual um proxy de thread pode ser executado. |
| Estrutura scheduler_interface | Interface do agendador |
| Estrutura scheduler_ptr (Runtime de Simultaneidade) | Representa um ponteiro para um agendador. Esta classe existe para permitir a especificação de um tempo de vida compartilhado usando shared_ptr ou apenas uma referência simples usando um ponteiro bruto. |
Enumerações
| Nome | Descrição |
|---|---|
| agent_status | Os estados válidos para um agent. |
| Agents_EventType | Os tipos de eventos que podem ser rastreados usando a funcionalidade de rastreamento oferecida pela Biblioteca de Agentes |
| ConcRT_EventType | Os tipos de eventos que podem ser rastreados usando a funcionalidade de rastreamento oferecida pelo Runtime de Simultaneidade. |
| Concrt_TraceFlags | Sinalizadores de rastreamento para os tipos de evento |
| CriticalRegionType | O tipo de região crítica em que um contexto está. |
| DynamicProgressFeedbackType | Usado pela política DynamicProgressFeedback para descrever se os recursos do agendador serão rebalanceados de acordo com as informações estatísticas coletadas do agendador ou apenas com base em processadores virtuais que entram e saem do estado ocioso por meio de chamadas aos métodos Activate e Deactivate na IVirtualProcessorRoot interface. Para mais informações sobre políticas de agendador disponíveis, confira PolicyElementKey. |
| join_type | O tipo de um bloco de mensagens join. |
| message_status | As respostas válidas para uma oferta de um objeto message para um bloco. |
| PolicyElementKey | Chaves de política que descrevem aspectos do comportamento do agendador. Cada elemento de política é descrito por um par chave-valor. Para mais informações sobre as políticas do agendador e seu impacto sobre os agendadores, confira Agendador de Tarefas. |
| SchedulerType | Usado pela política SchedulerKind para descrever o tipo de thread que o agendador deve utilizar para contextos de execução subjacentes. Para mais informações sobre políticas de agendador disponíveis, confira PolicyElementKey. |
| SchedulingProtocolType | Usado pela política SchedulingProtocol para descrever qual algoritmo de agendamento será utilizado para o agendador. Para mais informações sobre políticas de agendador disponíveis, confira PolicyElementKey. |
| SwitchingProxyState | Usado para indicar o estado em que um proxy de thread está, quando ele está executando uma opção de contexto cooperativa para um proxy de thread diferente. |
| task_group_status | Descreve o status de execução de um objeto task_group ou structured_task_group. Um valor desse tipo é retornado por vários métodos que aguardam a conclusão de tarefas agendadas para um grupo de tarefas. |
| WinRTInitializationType | Usado pela política WinRTInitialization para descrever se e como o Windows Runtime será inicializado em threads de agendador para um aplicativo executado em sistemas operacionais com versão Windows 8 ou superior. Para mais informações sobre políticas de agendador disponíveis, confira PolicyElementKey. |
Funções
| Nome | Descrição |
|---|---|
| Função de alocação | Aloca um bloco de memória do tamanho especificado no Subalocador de Cache de Runtime de Simultaneidade. |
| Função asend | Sobrecarregado. Uma operação de envio assíncrona, que agenda uma tarefa para propagar os dados para o bloco de destino. |
| cancel_current_task Function | Cancela a tarefa atualmente em execução. Essa função pode ser chamada de dentro do corpo de uma tarefa para interromper a execução da tarefa e fazer com que ela entre no estado canceled.Não é um cenário com suporte para chamar essa função se você não estiver dentro do corpo de uma task. Isso resultará em um comportamento indefinido, tal como um travamento ou falta de resposta em seu aplicativo. |
| create_async Function | Cria uma construção assíncrona de Windows Runtime com base em um objeto de função ou lambda fornecido pelo usuário. O tipo de retorno de create_async é IAsyncAction^, IAsyncActionWithProgress<TProgress>^, IAsyncOperation<TResult>^ ou IAsyncOperationWithProgress<TResult, TProgress>^ com base na assinatura do lambda passada para o método. |
| create_task Function | Sobrecarregado. Cria um objeto de tarefa PPL. create_task pode ser usado em qualquer lugar que você teria usado um construtor de tarefas. Ele é fornecido principalmente para conveniência, pois permite o uso da palavra-chave auto durante a criação de tarefas. |
| Função CreateResourceManager | Retorna uma interface que representa a instância singleton do Resource Manager do Runtime de Simultaneidade. O Resource Manager é responsável por atribuir recursos a agendadores que desejam cooperar entre si. |
| Função DisableTracing | Desabilita o rastreamento no Runtime de Simultaneidade. Essa função foi preterida porque o rastreamento ETW não é registrado por padrão. |
| Função EnableTracing | Habilita o rastreamento no Runtime de Simultaneidade. Essa função foi preterida porque o rastreamento ETW agora é ativado por padrão. |
| Função Free | Libera um bloco de memória alocado anteriormente pelo método Alloc para o Subalocador de Cache de Runtime de Simultaneidade. |
| Função get_ambient_scheduler (Runtime de Simultaneidade) | |
| GetExecutionContextId Function | Retorna um identificador exclusivo que pode ser atribuído a um contexto de execução que implementa a interface IExecutionContext. |
| Função GetOSVersion | Retorna a versão do sistema operacional. |
| Função GetProcessorCount | Retorna o número de threads de hardware no sistema subjacente. |
| Função GetProcessorNodeCount | Retorna o número de nós NUMA ou pacotes de processador no sistema subjacente. |
| Função GetSchedulerId | Retorna um identificador exclusivo que pode ser atribuído a um agendador que implementa a interface IScheduler. |
| interruption_point Função | Cria um ponto de interrupção para cancelamento. Se um cancelamento estiver em andamento no contexto em que essa função é chamada, isso gerará uma exceção interna que anula a execução do trabalho paralelo em execução no momento. Se o cancelamento não estiver em andamento, a função não faz nada. |
| Função is_current_task_group_canceling | Indica se o grupo de tarefas executando de forma embutida no contexto atual está no meio de um cancelamento ativo (ou estará em breve). Observe que, se não houver um grupo de tarefas em execução embutido no contexto atual, false será retornado. |
| Função make_choice | Sobrecarregado. Constrói um bloco de mensagens choice de Scheduler ou ScheduleGroup opcionais e duas ou mais fontes de entrada. |
| make_greedy_join Função | Sobrecarregado. Constrói um bloco de mensagens greedy multitype_join de Scheduler ou ScheduleGroup opcionais e duas ou mais fontes de entrada. |
| Função make_join | Sobrecarregado. Constrói um bloco de mensagens non_greedy multitype_join de Scheduler ou ScheduleGroup opcionais e duas ou mais fontes de entrada. |
| make_task Função | Um método de fábrica para criar um objeto task_handle. |
| Função parallel_buffered_sort | Sobrecarregado. Organiza os elementos de um intervalo especificado em ordem não decrescente ou de acordo com um critério de ordenação especificado por um predicado binário em paralelo. Essa função é semanticamente semelhante a std::sort em que é uma classificação com base em comparação, instável, no local, exceto que precisa de espaço adicional O(n) e requer a inicialização padrão para os elementos que estão sendo classificados. |
| Função parallel_for | Sobrecarregado. parallel_for itera em um intervalo de índices e executa uma função fornecida pelo usuário em cada iteração, em paralelo. |
| Função parallel_for_each | Sobrecarregado. parallel_for_each aplica uma função especificada a cada elemento dentro de um intervalo, em paralelo. É semanticamente equivalente à função for_each no namespace std, exceto que a iteração sobre os elementos é executada em paralelo e a ordem de iteração não é especificada. O argumento _Func deve dar suporte a um operador de chamada de função do formulário operator()(T) em que o parâmetro T é o tipo de item do contêiner que está sendo iterado. |
| parallel_invoke Função | Sobrecarregado. Executa os objetos de função fornecidos como parâmetros em paralelo e bloqueia até que eles tenham terminado de executar. Cada objeto de função pode ser uma expressão lambda, um ponteiro para a função ou qualquer objeto que dê suporte ao operador de chamada de função com a assinatura void operator()(). |
| Função parallel_radixsort | Sobrecarregado. Organiza elementos em um intervalo especificado em ordem não decrescente usando um algoritmo de classificação de base. Essa é uma função de classificação estável que requer uma função de projeção que pode projetar elementos a serem classificados em chaves semelhantes a inteiros sem sinal. A inicialização padrão é necessária para os elementos que estão sendo classificados. |
| parallel_reduce Função | Sobrecarregado. Calcula a soma de todos os elementos em um intervalo especificado, ao calcular somas parciais sucessivas ou calcula o resultado de resultados parciais sucessivos obtidos usando uma operação binária especificada diferente da soma em paralelo. parallel_reduce é semanticamente semelhante a std::accumulate, exceto que requer que a operação binária seja associativa e requer um valor de identidade em vez de um valor inicial. |
| Função parallel_sort | Sobrecarregado. Organiza os elementos de um intervalo especificado em ordem não decrescente ou de acordo com um critério de ordenação especificado por um predicado binário em paralelo. Essa função é semanticamente semelhante a std::sort que é uma classificação baseada em comparação, instável e local. |
| Função parallel_transform | Sobrecarregado. Aplica um objeto de função especificado a cada elemento em um intervalo de origem ou a um par de elementos de dois intervalos de origem e copia os valores de retorno do objeto de função em um intervalo de destino em paralelo. Esse funcional é semanticamente equivalente a std::transform. |
| Função de recebimento | Sobrecarregado. Uma implementação de recebimento geral, permitindo que um contexto aguarde dados de exatamente uma fonte e filtre os valores aceitos. |
| run_with_cancellation_token Function | Executa um objeto de função imediatamente e de forma síncrona no contexto de um determinado token de cancelamento. |
| Função de envio | Sobrecarregado. Uma operação de envio síncrona, que aguarda até que o destino aceite ou recuse a mensagem. |
| Função set_ambient_scheduler (Runtime de Simultaneidade) | |
| set_task_execution_resources Function | Sobrecarregado. Restringe os recursos de execução usados pelos threads de trabalho internos do Runtime de Simultaneidade ao conjunto de afinidades especificado. É válido chamar esse método somente antes que o Resource Manager tenha sido criado ou entre dois tempos de vida do Resource Manager. Ele pode ser invocado várias vezes desde que o Resource Manager não exista no momento da invocação. Depois que um limite de afinidade tiver sido definido, ele permanecerá em vigor até a próxima chamada válida para o método set_task_execution_resources.A máscara de afinidade fornecida não precisa ser um subconjunto da máscara de afinidade do processo. A afinidade do processo será atualizada, se necessário. |
| Função swap | Troca os elementos de dois objetos concurrent_vector. |
| Função task_from_exception (Runtime de Simultaneidade) | |
| Função task_from_result (Runtime de Simultaneidade) | |
| Trace_agents_register_name Function | Associa o nome fornecido ao bloco de mensagens ou ao agente no rastreamento ETW. |
| try_receive Function | Sobrecarregado. Uma implementação try-receive geral, permitindo que um contexto procure dados de exatamente uma fonte e filtre os valores aceitos. Se os dados não estiverem prontos, o método retornará false. |
| Função wait | Pausa o contexto atual por um período de tempo especificado. |
| Função when_all | Cria uma tarefa que será concluída com êxito quando todas as tarefas fornecidas como argumentos forem concluídas com êxito. |
| Função when_any | Sobrecarregado. Cria uma tarefa que será concluída com êxito quando todas as tarefas fornecidas como argumentos forem concluídas com êxito. |
Operadores
| Nome | Descrição |
|---|---|
| operator!= | Testa se o objeto concurrent_vector à esquerda do operador é diferente do objeto concurrent_vector à direita. |
| operadora&& | Sobrecarregado. Cria uma tarefa que será concluída com êxito quando ambas as tarefas fornecidas como argumentos forem concluídas com êxito. |
operator|| |
Sobrecarregado. Cria uma tarefa que será concluída com êxito quando uma das tarefas fornecidas como argumentos for concluída com êxito. |
| operator< | Testa se o objeto concurrent_vector à esquerda do operador é menor do que o objeto concurrent_vector à direita. |
| operator<= | Testa se o objeto concurrent_vector à esquerda do operador é menor que ou igual ao objeto concurrent_vector à direita. |
| operator== | Testa se o objeto concurrent_vector à esquerda do operador é igual ao objeto concurrent_vector à direita. |
| operator> | Testa se o objeto concurrent_vector à esquerda do operador é maior do que o objeto concurrent_vector à direita. |
| operator>= | Testa se o objeto concurrent_vector à esquerda do operador é maior que ou igual ao objeto concurrent_vector à direita. |
Constantes
| Nome | Descrição |
|---|---|
| AgentEventGuid | Um GUID de categoria ({B9B5B78C-0713-4898-A21A-C67949DCED07}) descrevendo eventos ETW disparados pela biblioteca Agentes no Runtime de Simultaneidade. |
| ChoreEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados a obrigações ou tarefas. |
| ConcRT_ProviderGuid | O GUID do provedor ETW para o Runtime de Simultaneidade. |
| CONCRT_RM_VERSION_1 | Indica o suporte à interface do Resource Manager definida no Visual Studio 2010. |
| ConcRTEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que não são descritos mais especificamente por outra categoria. |
| ContextEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados a contextos. |
| COOPERATIVE_TIMEOUT_INFINITE | Valor que indica que uma espera nunca deve atingir o tempo limite. |
| COOPERATIVE_WAIT_TIMEOUT | Valor que indica que uma espera atingiu o tempo limite. |
| INHERIT_THREAD_PRIORITY | Valor especial para a chave de política ContextPriority que indica que a prioridade de thread de todos os contextos no agendador deve ser igual à do thread que criou o agendador. |
| LockEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados a bloqueios. |
| MaxExecutionResources | Valor especial para as chaves de política MinConcurrency e MaxConcurrency. O padrão é o número de threads de hardware no computador na ausência de outras restrições. |
| PPLParallelForeachEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados ao uso da função parallel_for_each. |
| PPLParallelForEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados ao uso da função parallel_for. |
| PPLParallelInvokeEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados ao uso da função parallel_invoke. |
| ResourceManagerEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados ao gerenciador de recursos. |
| ScheduleGroupEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados aos grupos agendados. |
| SchedulerEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados à atividade do agendador. |
| VirtualProcessorEventGuid | Um GUID de categoria que descreve eventos ETW disparados pelo Runtime de Simultaneidade que estão diretamente relacionados a processadores virtuais. |
Requisitos
Cabeçalho: agents.h, concrt.h, concrtrm.h, concurrent_priority_queue.h, concurrent_queue.h, concurrent_unordered_map.h, concurrent_unordered_set.h, concurrent_vector.h, internal_concurrent_hash.h, internal_split_ordered_list.h, ppl.h, pplcancellation_token.h, pplconcrt.h, pplinterface.h, ppltasks.h