Freigeben über


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

Siehe auch

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Threadpools