Funzione CreateThreadpool (threadpoolapiset.h)

Articolo
03/02/2024

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