CreateThreadpool-Funktion (threadpoolapiset.h)
Weist einen neuen Pool von Threads zu, um Rückrufe auszuführen.
Syntax
PTP_POOL CreateThreadpool(
PVOID reserved
);
Parameter
reserved
Dieser Parameter ist reserviert und muss NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie einen Zeiger auf eine TP_POOL Struktur zurück, die den neu zugeordneten Threadpool darstellt. Anwendungen ändern die Member dieser Struktur nicht.
Wenn die Funktion fehlschlägt, wird NULL zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Nach dem Erstellen des neuen Threadpools sollten Sie SetThreadpoolThreadMaximum aufrufen, um die maximale Anzahl von Threads anzugeben, die der Pool zuweisen kann, und SetThreadpoolThreadMinimum , um die mindeste Anzahl von threads anzugeben, die im Pool verfügbar sind.
Um den Pool zu verwenden, müssen Sie den Pool einer Rückrufumgebung zuordnen. Um die Rückrufumgebung zu erstellen, rufen Sie InitializeThreadpoolEnvironment auf. Rufen Sie dann SetThreadpoolCallbackPool auf, um den Pool der Rückrufumgebung zuzuordnen.
Um den Threadpool freizugeben, rufen Sie CloseThreadpool auf.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.
Beispiele
Ein Beispiel finden Sie unter Verwenden der Threadpoolfunktionen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | threadpoolapiset.h (einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |