Thread Pool API

L'API (Thread Pool Application Programming Interface) usa una progettazione basata su oggetti. Ognuno degli oggetti seguenti è rappresentato da una struttura di dati in modalità utente:

• Un oggetto pool è un set di thread di lavoro che possono essere usati per eseguire il lavoro. Ogni processo può creare più pool isolati con caratteristiche diverse in base alle esigenze. È disponibile anche un pool predefinito per ogni processo.
• Un gruppo di pulizia è associato a un set di oggetti di generazione di callback. Le funzioni esistono per attendere e rilasciare tutti gli oggetti membri di ogni gruppo di pulizia. In questo modo l'applicazione consente di tenere traccia di tutti gli oggetti creati.
• Un oggetto di lavoro viene assegnato a un pool e, facoltativamente, a un gruppo di pulizia. Può essere inserito, causando l'esecuzione del callback da parte di un thread di lavoro dal pool. Un oggetto di lavoro può avere più post in sospeso; ognuno genera un callback. L'operazione post non può avere esito negativo a causa della mancanza di risorse.
• Un oggetto timer controlla la pianificazione dei callback. Ogni volta che un timer scade, il callback viene inviato al pool di lavoro. L'impostazione di un timer non può avere esito negativo a causa della mancanza di risorse.
• Un oggetto wait fa sì che un thread waiter attenda un handle waitable. Dopo che l'attesa è stata soddisfatta o il periodo di timeout scade, il thread del waiter invia il callback degli oggetti wait al pool di lavoro dell'attesa. L'impostazione di un'attesa non può avere esito negativo a causa della mancanza di risorse.
• Un oggetto I/O associa un handle di file alla porta di completamento di I/O per il pool di thread. Al termine di un'operazione di I/O asincrona, un thread di lavoro preleva lo stato dell'operazione e chiama il callback dell'oggetto I/O.

Nella tabella seguente vengono descritte le funzionalità delle API del pool di thread originali e correnti.

Funzionalità	API originale	API corrente
Sincrono	Registerwaitforsingleobject UnregisterWaitEx	CloseThreadpoolWait CreateThreadpoolWait SetThreadpoolWait WaitForThreadpoolWaitCallbacks
Lavoro	Queueuserworkitem	CloseThreadpoolWork CreateThreadpoolWork SubmitThreadpoolWork TrySubmitThreadpoolCallback WaitForThreadpoolWorkCallbacks
Timer	CreateTimerQueue CreateTimerQueueTimer ChangeTimerQueueTimer DeleteTimerQueueTimer DeleteTimerQueueEx	CloseThreadpoolTimer CreateThreadpoolTimer IsThreadpoolTimerSet SetThreadpoolTimer WaitForThreadpoolTimerCallbacks
I/O	BindIoCompletionCallback	CancelThreadpoolIo CloseThreadpoolIo CreateThreadpoolIo StartThreadpoolIo WaitForThreadpoolIoCallbacks
Gruppo di pulizia		CloseThreadpoolCleanupGroup Closethreadpoolcleanupgroupmembers CreateThreadpoolCleanupGroup
Pool		CloseThreadpool CreateThreadpool SetThreadpoolThreadMaximum SetThreadpoolThreadMinimum
Ambiente di callback		DestroyThreadpoolEnvironment InitializeThreadpoolEnvironment SetThreadpoolCallbackCleanupGroup SetThreadpoolCallbackLibrary SetThreadpoolCallbackPool SetThreadpoolCallbackPriority SetThreadpoolCallbackRunsLong
Callback		CallbackMayRunLong
Pulizia del callback		DisassociateCurrentThreadFromCallback FreeLibraryWhenCallbackReturns LeaveCriticalSectionWhenCallbackReturns ReleaseMutexWhenCallbackReturns ReleaseSemaphoreWhenCallbackReturns SetEventWhenCallbackReturns

 

Argomenti correlati

Pool di thread

Uso delle funzioni del pool di thread