Condividi tramite


Spazio dei nomi concurrency

Lo spazio dei nomi Concurrency fornisce le classi e le funzioni che consentono l'accesso al runtime di concorrenza, un framework di programmazione simultaneo per C++. Per ulteriori informazioni, vedere Runtime di concorrenza.

namespace concurrency;

Membri

Spazi dei nomi

Nome

Descrizione

concurrency::extensibility Namespace

Definizioni typedef

Nome

Descrizione

runtime_object_identity

Ogni istanza del messaggio dispone di un'identità che lo segue quando viene duplicato e viene passato tra i componenti della messaggistica. Non può corrispondere all'indirizzo dell'oggetto del messaggio.

task_status

Tipo che rappresenta lo stato finale di un'attività. I valori validi sono completed e canceled.

TaskProc

Un'astrazione elementare per un'attività, definita come void (__cdecl * TaskProc)(void *). TaskProc è chiamato per richiamare il corpo di un'attività.

TaskProc_t

Un'astrazione elementare per un'attività, definita come void (__cdecl * TaskProc_t)(void *). TaskProc è chiamato per richiamare il corpo di un'attività.

Classi

Nome

Descrizione

Classe affinity_partitioner

La classe affinity_partitioner è simile alla classe static_partitioner, ma migliora l'affinità della cache dalla sua scelta di mappare dei sottointervalli ai thread di lavoro. Può migliorare significativamente le prestazioni quando un ciclo viene eseguito di nuovo sullo stesso insieme di dati e i dati si adattano nella cache. Si noti che lo stesso oggetto affinity_partitioner deve essere utilizzato con le iterazioni successive di un ciclo parallelo che viene eseguito su un particolare set di dati, per trarre vantaggio dalla località dei dati.

Classe agent

Classe destinata all'utilizzo come classe di base per tutti gli agenti indipendenti. Si utilizza per nascondere lo stato dagli altri agenti e interagire attraverso il passaggio di messaggi.

Classe auto_partitioner

La classe auto_partitioner rappresenta il metodo predefinito parallel_for, parallel_for_each e parallel_transform utilizzato per partizionare l'intervallo su cui iterano. Questo metodo di partizionamento dell'intervallo di employes si impossessa del bilanciamento del carico così come dell'annullamento per iterazione.

Classe bad_target

Questa classe descrive un'eccezione generata quando un blocco della messaggistica riceve un puntatore a una destinazione non valida per l'operazione eseguita.

Classe call

Un blocco della messaggistica call è un oggetto target_block multi-origine ordinato che richiama una funzione specificata quando riceve un messaggio.

Classe cancellation_token

La classe cancellation_token rappresenta la possibilità di determinare se è stato richiesto l'annullamento di una determinata operazione. Un token specificato può essere associato a task_group, structured_task_group o a task per consentire l'annullamento implicito. Può inoltre essere sottoposto a polling per l'annullamento o disporre di un callback registrato se e quando l'oggetto cancellation_token_source associato viene annullato.

Classe cancellation_token_registration

La classe cancellation_token_registration rappresenta una notifica di callback da cancellation_token. Quando il metodo register in cancellation_token viene utilizzato per ricevere la notifica di quando si verifica l'annullamento, un oggetto cancellation_token_registration viene restituito come handle al callback in modo che il chiamante può richiedere che un callback specifico non venga eseguito tramite l'utilizzo del metodo deregister.

Classe cancellation_token_source

La classe cancellation_token_source rappresenta la possibilità di annullare una determinata operazione annullabile.

Classe choice

Un blocco della messaggistica choice è un blocco multi-origine a destinazione singola che rappresenta un'interazione del flusso di controllo con un set di origini. Il blocco di prima qualità attenderà che una qualsiasi delle molteplici origini produca un messaggio e propagherà l'indice dell'origine che ha prodotto il messaggio.

Classe combinable

L'oggetto combinable<T> ha lo scopo di fornire copie di dati di thread privato, per eseguire calcoli secondari locali per thread senza blocco durante algoritmi paralleli. Alla fine dell'operazione parallela, è possibile unire i sub-calcoli del thread privato in un risultato finale. Questa classe è utilizzabile al posto di una variabile condivisa e può comportare un miglioramento nelle prestazioni qualora vi fosse in caso contrario molto conflitto su tale variabile condivisa.

Classe concurrent_priority_queue

La classe concurrent_priority_queue è un contenitore che consente a più thread di inserire e togliere elementi contemporaneamente. Gli elementi vengono prelevati secondo un ordine di priorità dove la priorità è determinata da una funzione fornita come argomento del modello.

Classe concurrent_queue

La classe concurrent_queue è una classe contenitore di sequenze che consente l'accesso di tipo First-in First-out ai relativi elementi. Abilita un set limitato di operazioni sicure per concorrenza, quali push e try_pop, per citarne alcune.

Classe concurrent_unordered_map

La classe concurrent_unordered_map è un contenitore indipendente dalla concorrenza che controlla una sequenza di lunghezza variabile di elementi di tipo std::pair<const _Key_type, _Element_type>. La sequenza viene rappresentata in un modo che abilita le operazioni di accodamento, accesso elementi, accesso iteratori e attraversamento iteratori in modo indipendente dalla concorrenza.

Classe concurrent_unordered_multimap

La classe concurrent_unordered_multimap è un contenitore indipendente dalla concorrenza che controlla una sequenza di lunghezza variabile di elementi di tipo std::pair<const _Key_type, _Element_type>. La sequenza viene rappresentata in un modo che abilita le operazioni di accodamento, accesso elementi, accesso iteratori e attraversamento iteratori in modo indipendente dalla concorrenza.

Classe concurrent_unordered_multiset

La classe concurrent_unordered_multiset è un contenitore indipendente dalla concorrenza che controlla una sequenza di lunghezza variabile di elementi di tipo _Key_type. La sequenza viene rappresentata in un modo che abilita le operazioni di accodamento, accesso elementi, accesso iteratori e attraversamento iteratori in modo indipendente dalla concorrenza.

Classe concurrent_unordered_set

La classe concurrent_unordered_set è un contenitore indipendente dalla concorrenza che controlla una sequenza di lunghezza variabile di elementi di tipo _Key_type. La sequenza viene rappresentata in un modo che abilita le operazioni di accodamento, accesso elementi, accesso iteratori e attraversamento iteratori in modo indipendente dalla concorrenza.

Classe concurrent_vector

La classe concurrent_vector è una classe contenitore di sequenze che consente un accesso casuale a qualsiasi elemento. Abilita accodamento, accesso dell'elemento, accesso dell'iteratore e operazioni traversali di iterazione indipendenti dalla concorrenza.

Classe Context

Consente di rappresentare un'astrazione per un contesto di esecuzione.

Classe context_self_unblock

Questa classe descrive un'eccezione generata quando il metodo Unblock di un oggetto Context viene chiamato dallo stesso contesto. Potrebbe indicare un tentativo da parte di un contesto specificato di sbloccarsi.

Classe context_unblock_unbalanced

Questa classe descrive un'eccezione generata quando le chiamate ai metodi Block e Unblock di un oggetto Context non sono abbinate correttamente.

Classe critical_section

Un'esclusione reciproca non rientrante che tiene conto in modo esplicito del runtime di concorrenza.

Classe CurrentScheduler

Consente di rappresentare un'astrazione per l'utilità di pianificazione corrente associata al contesto di chiamata.

Classe default_scheduler_exists

Questa classe descrive un'eccezione generata quando il metodo Scheduler::SetDefaultSchedulerPolicy viene chiamato quando esiste già un'utilità di pianificazione predefinita all'interno del processo.

Classe event

Un evento di reimpostazione manuale che tiene conto in modo esplicito del runtime di concorrenza.

Classe improper_lock

Questa classe descrive un'eccezione generata quando un blocco viene acquisito in modo errato.

Classe improper_scheduler_attach

Questa classe descrive un'eccezione generata quando il metodo Attach viene chiamato su un oggetto Scheduler già allegato al contesto corrente.

Classe improper_scheduler_detach

Questa classe descrive un'eccezione generata quando il metodo CurrentScheduler::Detach viene chiamato su un contesto che non è stato allegato ad alcuna unità di pianificazione tramite il metodo Attach di un oggetto Scheduler.

Classe improper_scheduler_reference

Questa classe descrive un'eccezione generata quando il metodo Reference viene chiamato su un oggetto Scheduler che si sta chiudendo, da un contesto che non fa parte dell'unità di pianificazione.

Classe invalid_link_target

Questa classe descrive un'eccezione generata quando il metodo link_target di un blocco della messaggistica viene chiamato e tale blocco non è in grado di collegarsi alla destinazione. Può essere il risultato del superamento del numero di collegamenti consentito dal blocco della messaggistica o del tentativo di collegare una destinazione specifica due volte alla stessa origine.

Classe invalid_multiple_scheduling

Questa classe descrive un'eccezione generata quando un oggetto task_handle è pianificato più volte utilizzando il metodo run di un oggetto task_group o structured_task_group senza una chiamata intermedia a uno dei metodi wait o run_and_wait.

Classe invalid_operation

Questa classe descrive un'eccezione generata quando viene eseguita un'operazione non valida non più descritta in maniera accurata da un altro tipo di eccezione generata dal runtime di concorrenza.

Classe invalid_oversubscribe_operation

Questa classe descrive un'eccezione generata quando il metodo Context::Oversubscribe viene chiamato con il parametro _BeginOversubscription impostato su false senza una chiamata precedente al metodo Context::Oversubscribe con il parametro _BeginOversubscription impostato su true.

Classe invalid_scheduler_policy_key

Questa classe descrive un'eccezione generata quando una chiave non valida o sconosciuta viene passata a un costruttore dell'oggetto SchedulerPolicy o il metodo SetPolicyValue di un oggetto SchedulerPolicy viene passato a una chiave che deve essere modificata attraverso altri mezzi come, ad esempio, il metodo SetConcurrencyLimits.

Classe invalid_scheduler_policy_thread_specification

Questa classe descrive un'eccezione generata quando si tenta di impostare i limiti di concorrenza di un oggetto SchedulerPolicy in modo che il valore della chiave MinConcurrency sia inferiore a quella della chiave MaxConcurrency.

Classe invalid_scheduler_policy_value

Questa classe descrive un'eccezione generata quando una chiave dei criteri di un oggetto SchedulerPolicy viene impostata su un valore non valido per tale chiave.

Classe ISource

La classe ISource corrisponde all'interfaccia per tutti i blocchi di origine. I blocchi di origine propagano messaggi nei blocchi ITarget.

Classe ITarget

La classe ITarget corrisponde all'interfaccia per tutti i blocchi di destinazione. I blocchi di destinazione utilizzano messaggi a loro offerti da blocchi ISource.

Classe join

Un blocco della messaggistica join è un propagator_block multi-origine, a destinazione singola, che combina insieme messaggi di tipo _Type da ognuna delle origini.

Classe location

Un'astrazione di una locazione fisica sull'hardware.

Classe message

Busta del messaggio di base contenente il payload dei dati passati tra blocchi della messaggistica.

Classe message_not_found

Questa classe descrive un'eccezione generata quando un blocco della messaggistica non è in grado di trovare un messaggio richiesto.

Classe message_processor

La classe message_processor rappresenta la classe base astratta per l'elaborazione degli oggetti message. Non esiste garanzia sull'ordinamento dei messaggi.

Classe missing_wait

Questa classe descrive un'eccezione generata quando vi sono attività ancora pianificate per un oggetto task_group o structured_task_group nel momento di esecuzione del distruttore dell'oggetto. Questa eccezione non sarà mai generata se il distruttore viene raggiunto a causa del processo di rimozione dello stack come risultato di un'eccezione.

Classe multi_link_registry

L'oggetto multi_link_registry è un network_link_registry che gestisce più blocchi di origine o più blocchi di destinazione.

Classe multitype_join

Un blocco della messaggistica multitype_join è un blocco multi-origine, a destinazione singola, che combina messaggi di diverso tipo da ciascuna delle sue origini e offre una tupla dei messaggi combinati alle sue destinazioni.

Classe nested_scheduler_missing_detach

Questa classe descrive un'eccezione generata quando il runtime di concorrenza rileva che non è sta eseguita la chiamata al metodo CurrentScheduler::Detach su un contesto allegato a una seconda utilità di pianificazione attraverso il metodo Attach dell'oggetto Scheduler.

Classe network_link_registry

La classe base astratta network_link_registry gestisce i collegamenti tra i blocchi di origine e quelli di destinazione.

Classe operation_timed_out

Questa classe descrive un'eccezione generata quando un'operazione è scaduta.

Classe ordered_message_processor

Un ordered_message_processor è un message_processor che consente ai blocchi del messaggio di elaborare messaggi nell'ordine in cui vengono ricevuti.

Classe overwrite_buffer

Un blocco della messaggistica overwrite_buffer è un propagator_block multi-origine a destinazione singola, in grado di archiviare un unico messaggio alla volta. I nuovi messaggi sovrascrivono i precedenti.

Classe progress_reporter

La classe del reporter dello stato di avanzamento consente la creazione di rapporti per notifiche dello stato di avanzamento di un tipo specifico. Ogni oggetto progress_reporter è associato a una determinata azione o operazione asincrona.

Classe propagator_block

La classe propagator_block è una classe base astratta per blocchi di messaggio che sono sia origine sia destinazione. Combina la funzionalità delle classi source_block e target_block.

Classe reader_writer_lock

Un blocco reader-writer basato sulla coda di preferenza writer con solo spin locale. Il blocco concede l'accesso FIFO (first in - first out) a writer e può essere dannoso per i reader in condizioni di continuo caricamento di writer.

Classe ScheduleGroup

Consente di rappresentare un'astrazione per un gruppo di pianificazione. I gruppi di pianificazione organizzano un set di lavoro correlato che trae vantaggio da una chiusura pianificata a livello temporaneo, eseguendo un'altra attività nello stesso gruppo prima di spostarsi in un altro gruppo, o a livello spaziale, eseguendo più elementi all'interno dello stesso gruppo sullo stesso nodo NUMA o sul socket fisico.

Classe Scheduler

Consente di rappresentare un'astrazione per un'utilità di pianificazione del runtime di concorrenza.

Classe scheduler_not_attached

Questa classe descrive un'eccezione generata quando viene eseguita un'operazione che richiede un'utilità di pianificazione da allegare al contesto corrente e non lo è.

Classe scheduler_resource_allocation_error

Questa classe descrive un'eccezione generata a causa dell'errore per acquisire una risorsa critica nel runtime di concorrenza.

Classe scheduler_worker_creation_error

Questa classe descrive un'eccezione generata a causa di un errore nella creazione di un contesto di esecuzione del lavoro nel runtime di concorrenza.

Classe SchedulerPolicy

La classe SchedulerPolicy contiene un set di coppie chiave/valore, uno per ogni elemento dei criteri, che controllano il comportamento di un'istanza dell'utilità di pianificazione.

Classe simple_partitioner

La classe simple_partitioner rappresenta il partizionamento statico dell'intervallo iterato da parallel_for. Il partitioner divide l'intervallo in blocchi in modo che ogni blocco abbia almeno il numero di iterazioni specificate dalle dimensioni del blocco.

Classe single_assignment

Un blocco della messaggistica single_assignment è un propagator_block multi-origine, a destinazione singola, in grado di archiviare un unico message di sola scrittura.

Classe single_link_registry

L'oggetto single_link_registry è un network_link_registry che gestisce solo un singolo blocco di origine o di destinazione.

Classe source_block

La classe source_block è una classe base astratta per blocchi di sola origine. La classe fornisce funzionalità di gestione dei collegamenti di base come controlli dell'errore comune.

Classe source_link_manager

L'oggetto source_link_manager gestisce i collegamenti di rete dei blocchi della messaggistica nei blocchi ISource.

Classe static_partitioner

La classe static_partitioner rappresenta il partizionamento statico dell'intervallo iterato da parallel_for. Il partitioner divide l'intervallo in tanti blocchi quanti sono le unità di lavoro disponibili all'utilità di pianificazione sottostante.

Classe structured_task_group

La classe structured_task_group rappresenta una raccolta altamente strutturata di lavoro parallelo. È possibile mettere in coda attività parallele singole a un structured_task_group utilizzando gli oggetti task_handle e attenderne il completamento o annullamento del gruppo di attività prima di aver terminato l'esecuzione, che interromperà qualsiasi attività che non ha iniziato l'esecuzione.

Classe target_block

La classe target_block corrisponde a una classe base astratta che mette a disposizione la funzionalità di gestione dei collegamenti di base e il controllo degli errori per blocchi di sola destinazione.

Classe task (runtime di concorrenza)

La classe della libreria task Parallel Patterns Library (PPL). Un oggetto task rappresenta il lavoro che può essere eseguito in modo asincrono e contemporaneamente ad altre attività e il lavoro parallelo prodotto dagli algoritmi paralleli nel runtime di concorrenza. Genera un risultato di tipo _ResultType a operazione completata. Le attività di tipo task<void> non producono risultati. Un'attività può essere attesa o annullata indipendentemente dalle altre attività. Può inoltre essere composta da altre attività utilizzando modelli per continuazioni (then), join (when_all) e opzioni (when_any).

Classe task_canceled

Questa classe descrive un'eccezione generata dal livello di attività PPL per forzare l'attività corrente ad annullarsi. Viene inoltre generata dal metodo get() nell' attività, per un'attività annullata.

Classe task_completion_event

La classe task_completion_event consente di ritardare l'esecuzione di un'attività fino a soddisfare una condizione, o avviare un'attività in risposta a un evento esterno.

Classe task_continuation_context

La classe task_continuation_context consente di specificare dove si desidera eseguire una continuazione. L'utilizzo di questa classe è utile solo da un'applicazione Windows Store. Per le applicazioni non Windows Store, il contesto di esecuzione della continuazione di attività è determinato dal runtime e non è configurabile.

Classe task_group

La classe task_group rappresenta una raccolta di lavoro parallelo che può essere messa in attesa o annullato.

Classe task_handle

La classe task_handle rappresenta un elemento di lavoro parallelo individuale. Incapsula le istruzioni e i dati richiesti per eseguire un lavoro.

Classe task_options (runtime di concorrenza)

Rappresenta le opzioni consentite per la creazione di un'attività

Classe timer

Un blocco della messaggistica timer è un source_block in grado di inviare un messaggio alla sua destinazione dopo che è trascorso un determinato periodo di tempo oppure ad intervalli specifici.

Classe transformer

Un blocco della messaggistica transformer è un propagator_block multi-origine, a destinazione singola, che può accettare messaggi di un tipo ed è in grado di archiviare un numero non associato di messaggi di un tipo diverso.

Classe unbounded_buffer

Un blocco della messaggistica unbounded_buffer è un propagator_block multi-origine a destinazione singola, in grado di archiviare un numero non associato di messaggi di un tipo diverso.

Classe unsupported_os

Questa classe descrive un'eccezione generata quando viene utilizzato un sistema operativo non supportato.

Strutture

Nome

Descrizione

Struttura DispatchState

La struttura DispatchState è utilizzata per trasferire lo stato al metodo IExecutionContext::Dispatch. Descrive le circostanze in cui il metodo Dispatch viene richiamato su un'interfaccia IExecutionContext.

Struttura IExecutionContext

Un'interfaccia a un contesto di esecuzione che può essere in esecuzione su un processore virtuale specificato e il cui contesto può essere cambiato cooperativamente.

Struttura IExecutionResource

Un'astrazione per un thread di hardware.

Struttura IResourceManager

Un'interfaccia alla Gestione risorse del runtime di concorrenza. Si tratta dell'interfaccia con cui le utilità di pianificazione comunicano con Gestione risorse.

Struttura IScheduler

Un'interfaccia a un'astrazione di un'utilità di pianificazione del lavoro. Gestione risorse del runtime di concorrenza utilizza tale interfaccia per comunicare con le utilità di pianificazione del lavoro.

Struttura ISchedulerProxy

Interfaccia con cui le utilità di pianificazione comunicano con Gestione risorse del runtime di concorrenza per negoziare l'allocazione delle risorse.

Struttura IThreadProxy

Astrazione per un thread di esecuzione. A seconda della chiave di criteri SchedulerType dell'utilità di pianificazione che si crea, la Gestione risorse concederà un proxy del thread appoggiato da un thread Win32 normale o un thread UMS in modalità utente. I thread UMS sono supportati su sistemi operativi a 64 bit con Windows versione 7 e successive.

Struttura ITopologyExecutionResource

Un'interfaccia ad una risorsa di esecuzione come definita dal Gestione risorse.

Struttura ITopologyNode

Un'interfaccia a un nodo di topologia come definito da Gestione risorse. Un nodo contiene una o più risorse di esecuzione.

Struttura IUMSCompletionList

Consente di rappresentare un elenco di completamento UMS. Quando si blocca il thread UMS, il contesto di pianificazione definito dell'utilità di pianificazione viene inviato per decidere cosa pianificare sulla radice del processore virtuale sottostante mentre il thread originale è bloccato. Quando il thread originale si sblocca, il sistema operativo lo mette in coda nell'elenco di completamento accessibile tramite l'interfaccia. L'utilità di pianificazione può eseguire una query nell'elenco di completamento sul contesto di pianificazione designato o in qualsiasi altra posizione alla ricerca di lavoro.

Struttura IUMSScheduler

Un'interfaccia a un'astrazione di un'utilità di pianificazione di lavoro che desidera che la Gestione risorse del runtime di concorrenza passi thread UMS in modalità utente schedulable. Gestione risorse utilizza questa interfaccia per comunicare con le utilità di pianificazione del thread UMS. L'interfaccia IUMSScheduler eredita dall'interfaccia IScheduler.

Struttura IUMSThreadProxy

Astrazione per un thread di esecuzione. Se si desidera che all'utilità di pianificazione siano concessi thread UMS, impostare il valore per l'elemento dei criteri dell'utilità di pianificazione SchedulerKind su UmsThreadDefault e implementare l'interfaccia IUMSScheduler. I thread UMS sono supportati solo su sistemi operativi a 64 bit con Windows versione 7 e successive.

Struttura IUMSUnblockNotification

Consente di rappresentare una notifica da Gestione risorse che un proxy del thread, che ha bloccato e attivato un valore restituito al contesto di pianificazione definito dell'utilità di pianificazione, ha sbloccato ed è pronto per essere pianificato. Questa interfaccia non è valida una volta riprogrammato il contesto di esecuzione associato del proxy del thread, restituito dal metodo GetContext.

Struttura IVirtualProcessorRoot

Un'astrazione per un thread di hardware sulla quale può eseguire un proxy del thread.

Struttura scheduler_interface

Interfaccia dell'utilità di pianificazione

Struttura scheduler_ptr (runtime di concorrenza)

Rappresenta un puntatore a un'utilità di pianificazione. Questa classe esiste per consentire la specifica di una durata condivisa utilizzando shared_ptr o semplicemente un riferimento normale utilizzando il puntatore non elaborato.

Enumerazioni

Nome

Descrizione

Enumerazione agent_status

Stati validi per un agent.

Enumerazione Agents_EventType

Tipi di eventi che possono essere tracciati mediante la funzionalità di tracciatura offerta dalla Libreria di Agenti.

Enumerazione ConcRT_EventType

Tipi di eventi che possono essere tracciati mediante la funzionalità di tracciatura offerta dal runtime di concorrenza.

Enumerazione Concrt_TraceFlags

Flag di analisi per i tipi di evento

Enumerazione CriticalRegionType

Tipo di area critica in cui si trova un contesto.

Enumerazione DynamicProgressFeedbackType

Utilizzato dai criteri DynamicProgressFeedback per descrivere se le risorse per l'utilità di pianificazione saranno ribilanciate sulla base di informazioni statistiche raccolte dall'utilità di pianificazione o solo sulla base di processori virtuali che passano allo stato inattivo e viceversa tramite chiamate ai metodi Activate e Deactivate sull'interfaccia IVirtualProcessorRoot. Per ulteriori informazioni sui criteri dell'utilità di pianificazione disponibili, vedere Enumerazione PolicyElementKey.

Enumerazione join_type

Tipo di un blocco della messaggistica join.

Enumerazione message_status

Risposte valide per un'offerta di un oggetto message a un blocco.

Enumerazione PolicyElementKey

Chiavi dei criteri che descrivono aspetti del comportamento dell'utilità di pianificazione. Ciascun elemento dei criteri è descritto da una coppia chiave-valore. Per ulteriori informazioni sui criteri dell'utilità di pianificazione e l'impatto nelle utilità di pianificazione, vedere Utilità di pianificazione (runtime di concorrenza).

Enumerazione SchedulerType

Utilizzato dai criteri SchedulerKind per descrivere il tipo di thread che l'utilità di pianificazione deve utilizzare per i contesti di esecuzione sottostanti. Per ulteriori informazioni sui criteri dell'utilità di pianificazione disponibili, vedere Enumerazione PolicyElementKey.

Enumerazione SchedulingProtocolType

Utilizzato dai criteri SchedulingProtocol per descrivere quale algoritmo di pianificazione sarà utilizzato per l'utilità di pianificazione. Per ulteriori informazioni sui criteri dell'utilità di pianificazione disponibili, vedere Enumerazione PolicyElementKey.

Enumerazione SwitchingProxyState

Utilizzato per indicare lo stato in cui si trova un proxy del thread, quando è in esecuzione uno scambio di contesto cooperativo per un proxy del thread diverso.

Enumerazione task_group_status

Descrive lo stato di esecuzione di un oggetto task_group o structured_task_group. Un valore di questo tipo viene restituito da numerosi metodi che attendono le attività pianificate a un gruppo di attività da completare.

Enumerazione WinRTInitializationType

Utilizzato dai criteri WinRTInitialization per descrivere se e come il Windows Runtime verrà inizializzato sui thread dell'utilità di pianificazione per un'applicazione eseguita nei sistemi operativi con la versione Windows 8 o superiore. Per ulteriori informazioni sui criteri dell'utilità di pianificazione disponibili, vedere Enumerazione PolicyElementKey.

Funzioni

Nome

Descrizione

Funzione Alloc

Assegna un blocco di memoria dalle dimensioni specificate dal suballocatore di cache del runtime di concorrenza.

Funzione asend

Di overload. Un'operazione di invio asincrona che pianifica un'attività per propagare i dati nel blocco di destinazione.

Funzione cancel_current_task

Annulla l'attività attualmente in esecuzione. Questa funzione può essere chiamata dal corpo di un'attività per interrompere l'esecuzione dell'attività e indurla allo stato canceled. Poiché può essere utilizzata in risposta alla funzione is_task_cancellation_requested, è possibile utilizzarla separatamente, per avviare l'annullamento dell'attività attualmente in esecuzione.

Non è uno scenario supportato chiamare questa funzione se non si è all'interno del corpo di un oggetto task. Questa operazione provocherà un comportamento non definito come un arresto anomalo o un blocco nell'applicazione.

Funzione create_async

Crea un costrutto asincrono di Windows Runtime in base a un'espressione lambda o un oggetto funzione forniti dall'utente. Il tipo restituito create_async è uno tra IAsyncAction^, IAsyncActionWithProgress<TProgress>^, IAsyncOperation<TResult>^ o IAsyncOperationWithProgress<TResult, TProgress>^ basato sulla firma dell'espressione lambda passata al metodo.

Funzione create_task

Di overload. Crea un oggetto attività PPL. create_task può essere utilizzato ovunque si sarebbe utilizzato un costruttore di attività. Viene fornito principalmente per comodità, in quanto consente l'utilizzo della parola chiave auto durante la creazione delle attività.

Funzione CreateResourceManager

Consente di restituire un'interfaccia che rappresenta l'istanza singleton di Gestione risorse del runtime di concorrenza. Gestione risorse è responsabile dell'assegnazione di risorse a utilità di pianificazione che vogliono cooperare tra loro.

Funzione DisableTracing

Disabilita la tracciatura nel runtime di concorrenza. Questa funzione è deprecata poiché la traccia ETW non viene registrata per impostazione predefinita.

Funzione EnableTracing

Abilita la tracciatura nel runtime di concorrenza. Questa funzione è deprecata poiché la traccia ETW viene attivata per impostazione predefinita.

Funzione Free

Rilascia un blocco di memoria precedentemente allocato dal metodo Alloc al suballocatore di cache del runtime di concorrenza.

Funzione get_ambient_scheduler (runtime di concorrenza)

Funzione GetExecutionContextId

Consente di restituire un identificatore univoco che può essere assegnato a un contesto di esecuzione che implementa l'interfaccia IExecutionContext.

Funzione GetOSVersion

Consente di restituire la versione del sistema operativo.

Funzione GetProcessorCount

Consente di restituire il numero dei thread di hardware sul sistema sottostante.

Funzione GetProcessorNodeCount

Consente di restituire il numero di nodi NUMA o pacchetti del processore sul sistema sottostante.

Funzione GetSchedulerId

Consente di restituire un identificatore univoco che può essere assegnato a un'utilità di pianificazione che implementa l'interfaccia IScheduler.

Funzione interruption_point

Crea un punto di interruzione per l'annullamento. Se un annullamento è in corso nel contesto in cui questa funzione viene chiamata, questa genererà un'eccezione interna che interrompe l'esecuzione del lavoro parallelo attualmente in esecuzione. Se l'annullamento non è in corso, la funzione non esegue alcuna operazione.

Funzione is_current_task_group_canceling

Consente di restituire un'indicazione se il gruppo di attività attualmente in esecuzione inline sul contesto corrente si trova nel mezzo di un annullamento attivo (o lo sarà a breve). Notare che se non c'è nessun gruppo di attività attualmente in esecuzione inline sul contesto corrente, sarà restituito false.

Funzione is_task_cancellation_requested

Restituisce un'indicazione sull'eventuale ricezione di una richiesta di annullamento dell'esecuzione da parte di un'attività. Viene richiesto l'annullamento di un'attività se l'attività è stata creata con un token di annullamento e l'origine del token associata a tale token viene annullata.

Funzione make_choice

Di overload. Costruisce un blocco della messaggistica choice da uno Scheduler o ScheduleGroup facoltativo con due o più sorgenti di input.

Funzione make_greedy_join

Di overload. Costruisce un blocco della messaggistica greedy multitype_join da uno Scheduler o ScheduleGroup facoltativo con due o più sorgenti di input.

Funzione make_join

Di overload. Costruisce un blocco della messaggistica non_greedy multitype_join da uno Scheduler o ScheduleGroup facoltativo con due o più sorgenti di input.

Funzione make_task

Un metodo factory per la creazione di un oggetto task_handle.

Funzione parallel_buffered_sort

Di overload. Dispone gli elementi in un intervallo specificato in un ordine non decrescente, o secondo un criterio di ordinamento specificato da un predicato binario, in parallelo. Questa funzione è semanticamente simile a std::sort in quanto si tratta di un ordinamento basato sul confronto, instabile, sul posto., ma richiede uno spazio aggiuntivo pari a O(n) e richiede l'inizializzazione predefinita per gli elementi in fase di ordinamento.

Funzione parallel_for

Di overload. parallel_for scorre un intervallo di indici ed esegue una funzione fornita dall'utente a ogni iterazione, in parallelo.

Funzione parallel_for_each

Di overload. parallel_for_each applica una funzione specificata a ogni elemento all'interno di un intervallo, in parallelo. È semanticamente equivalente alla funzione for_each nello spazio dei nomi std, con l'eccezione che l'iterazione sugli elementi viene eseguita in parallelo e l'ordine di iterazione non è specificato. L'argomento _Func deve supportare un operatore di chiamata della funzione del form operator()(T) laddove il parametro T è il tipo di elemento del contenitore su cui viene eseguita l'iterazione.

Funzione parallel_invoke

Di overload. Esegue gli oggetti funzione forniti come parametri in parallelo e blocca fino al termine dell'esecuzione. Ogni oggetto funzione potrebbe essere un'espressione lambda, un puntatore a funzione o qualsiasi oggetto che supporta l'operatore della chiamata di funzione con la firma void operator()().

Funzione parallel_radixsort

Di overload. Dispone gli elementi in un intervallo specificato in un ordine non decrescente utilizzando l'algoritmo Radix Sort. Si tratta di una funzione stabile di ordinamento che richiede una funzione di proiezione che consente agli elementi del progetto di essere ordinati nelle chiavi di tipo intero senza segno. L'inizializzazione predefinita è necessaria per gli elementi da ordinare.

Funzione parallel_reduce

Di overload. Calcola la somma di tutti gli elementi in un intervallo specificato elaborando le somme parziali successive, o calcola il risultato dei risultati parziali successivi ottenuti analogamente tramite l'utilizzo di un'operazione binaria specificata diversa da quella di somma, in parallelo. parallel_reduce è semanticamente simile a std::accumulate, con la differenza che richiede un'operazione binaria di essere associativa e richiede un valore di identità anziché un valore iniziale.

Funzione parallel_sort

Di overload. Dispone gli elementi in un intervallo specificato in un ordine non decrescente, o secondo un criterio di ordinamento specificato da un predicato binario, in parallelo. Questa funzione è semanticamente simile a std::sort in quanto si tratta di un ordinamento basato sul confronto, instabile, sul posto.

Funzione parallel_transform

Di overload. Applica uno specifico oggetto funzione ad ogni elemento in un intervallo di origine, o ad una coppia di elementi da due intervalli di origine e copia i valori restituiti dell'oggetto funzione in un intervallo di destinazione, in parallelo. Questa funzione è semanticamente equivalente a std::transform.

Funzione receive

Di overload. Un'implementazione di ricezione generale, che consente a un contesto di attendere i dati esattamente da un'origine e di filtrare i valori accettati.

Funzione run_with_cancellation_token

Esegue un oggetto funzione immediatamente e in modo sincrono nel contesto di uno specifico token di annullamento.

Funzione send

Di overload. Un'operazione di invio sincrona che attende fino a quando la destinazione accetta o rifiuta il messaggio.

Funzione set_ambient_scheduler (runtime di concorrenza)

Funzione set_task_execution_resources

Di overload. Limita le risorse di esecuzione utilizzate dai thread di lavoro interni del runtime di concorrenza al set di affinità specificato.

È valido chiamare questo metodo solo prima che il Gestione Risorse sia stato creato, né tra due cicli di vita di Gestione risorse. Può essere chiamato più volte fino a quando Gestione Risorse non esiste al momento dell'invocazione. Dopo aver impostato un limite di affinità, rimane attiva fino alla successiva chiamata al metodo set_task_execution_resources.

La maschera di affinità fornita non deve essere un sottoinsieme della maschera di affinità del processo. L'affinità del processo verrà aggiornata se necessario.

Funzione swap

Scambia gli elementi di due oggetti concurrent_vector.

Funzione task_from_exception (runtime di concorrenza)

Funzione task_from_result (runtime di concorrenza)

Funzione Trace_agents_register_name

Associa il nome specificato con il blocco di messaggi o l'agente nella traccia ETW.

Funzione try_receive

Di overload. Un'implementazione di ricezione try generale, che consente a un contesto di cercare i dati esattamente da un'origine e di filtrare i valori accettati. Se i dati non sono pronti, il metodo restituirà false.

Funzione wait

Consente di sospendere il contesto corrente per un intervallo di tempo specificato.

Funzione when_all

Crea un'attività che verrà completata correttamente quando tutte le attività fornite come argomenti verranno completate correttamente.

Funzione when_any

Di overload. Crea un'attività che verrà completata correttamente quando tutte le attività fornite come argomenti verranno completate correttamente.

Operatori

Nome

Descrizione

Operatore operator!=

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore non è uguale all'oggetto concurrent_vector sul lato destro.

Operatore operator&&

Di overload. Crea un'attività che verrà completata correttamente quando entrambe le attività fornite come argomenti verranno completate correttamente.

Operatore operator||

Di overload. Crea un'attività che verrà completata correttamente quando le attività fornite come argomenti verranno completate correttamente.

Operatore operator<

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore è minore dell'oggetto concurrent_vector sul lato destro.

Operatore operator<=

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore è minore o uguale all'oggetto concurrent_vector sul lato destro.

Operatore operator==

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore è uguale all'oggetto concurrent_vector sul lato destro.

Operatore operator>

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore è maggiore dell'oggetto concurrent_vector sul lato destro.

Operatore operator>=

Consente di verificare se l'oggetto concurrent_vector sul lato sinistro dell'operatore è maggiore o uguale all'oggetto concurrent_vector sul lato destro.

Costanti

Nome

Descrizione

Costante AgentEventGuid

Un GUID di categoria ({B9B5B78C-0713-4898-A21A-C67949DCED07}) che descrive gli eventi ETW generati dalla libreria di agenti nel runtime di concorrenza.

Costante ChoreEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati ad attività di routine o attività.

Costante ConcRT_ProviderGuid

GUID del provider ETW per il runtime di concorrenza.

Costante CONCRT_RM_VERSION_1

Indica supporto dell'interfaccia Gestione risorse definito in Visual Studio 2010.

Costante ConcRTEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che non sono descritti in maniera più specifica da un'altra categoria.

Costante ContextEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati a contesti.

Costante COOPERATIVE_TIMEOUT_INFINITE

Valore indicante un'attesa che non deve terminare mai.

Costante COOPERATIVE_WAIT_TIMEOUT

Valore indicante un'attesa terminata.

Costante INHERIT_THREAD_PRIORITY

Valore speciale per le chiavi dei criteri ContextPriority che indicano che la priorità del thread di tutti i contesti nell'utilità di pianificazione deve essere identica a quella del thread che ha creato l'utilità di pianificazione.

Costante LockEventGuid

GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza direttamente correlati ai blocchi.

Costante MaxExecutionResources

Valore speciale per le chiavi dei criteri MinConcurrency e MaxConcurrency. Viene meno al numero di thread di hardware sul computer nell'assenza di altri vincoli.

Costante PPLParallelForeachEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati all'uso della funzione parallel_for_each.

Costante PPLParallelForEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati all'uso della funzione parallel_for.

Costante PPLParallelInvokeEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati all'uso della funzione parallel_invoke.

Costante ResourceManagerEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati al gestore delle risorse.

Costante ScheduleGroupEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati a gruppi di pianificazione.

Costante SchedulerEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati all'attività dell'utilità di pianificazione.

Costante VirtualProcessorEventGuid

Una GUID di categoria che descrive eventi ETW generati dal runtime di concorrenza che sono direttamente correlati a processori virtuali.

Requisiti

Intestazione: 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

Vedere anche

Altre risorse

Riferimento (runtime di concorrenza)