CreateThreadpool, fonction (threadpoolapiset.h)
Alloue un nouveau pool de threads pour exécuter des rappels.
Syntaxe
PTP_POOL CreateThreadpool(
PVOID reserved
);
Paramètres
reserved
Ce paramètre est réservé et doit avoir la valeur NULL.
Valeur retournée
Si la fonction réussit, elle retourne un pointeur vers une structure TP_POOL représentant le pool de threads nouvellement alloué. Les applications ne modifient pas les membres de cette structure.
En cas d’échec de la fonction, elle retourne NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Remarques
Après avoir créé le pool de threads, vous devez appeler SetThreadpoolThreadMaximum pour spécifier le nombre maximal de threads que le pool peut allouer et SetThreadpoolThreadMinimum pour spécifier le nombre minimal de threads disponibles dans le pool.
Pour utiliser le pool, vous devez associer le pool à un environnement de rappel. Pour créer l’environnement de rappel, appelez InitializeThreadpoolEnvironment. Ensuite, appelez SetThreadpoolCallbackPool pour associer le pool à l’environnement de rappel.
Pour libérer le pool de threads, appelez CloseThreadpool.
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou une version ultérieure.
Exemples
Pour obtenir un exemple, consultez Utilisation des fonctions de pool de threads.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | threadpoolapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |