Funzione CreateThreadpool (threadpoolapiset.h)
Alloca un nuovo pool di thread per eseguire callback.
Sintassi
PTP_POOL CreateThreadpool(
PVOID reserved
);
Parametri
reserved
Questo parametro è riservato e deve essere NULL.
Valore restituito
Se la funzione ha esito positivo, restituisce un puntatore a una struttura TP_POOL che rappresenta il pool di thread appena allocato. Le applicazioni non modificano i membri di questa struttura.
Se la funzione ha esito negativo, restituisce NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
Dopo aver creato il nuovo pool di thread, è necessario chiamare SetThreadThreadMaximum per specificare il numero massimo di thread che il pool può allocare e SetThreadpoolThreadMinimum per specificare il numero minimo di thread disponibili nel pool.
Per usare il pool, è necessario associare il pool a un ambiente di callback. Per creare l'ambiente di callback, chiamare InitializeThreadpoolEnvironment. Chiamare quindi SetThreadpoolCallbackPool per associare il pool all'ambiente di callback.
Per rilasciare il pool di thread, chiamare CloseThreadpool.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.
Esempio
Per un esempio, vedere Uso delle funzioni del pool di thread.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | threadpoolapiset.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |