Fungsi CreateThreadpool (threadpoolapiset.h)

Artikel
03/02/2024

Mengalokasikan kumpulan utas baru untuk menjalankan panggilan balik.

Sintaks

PTP_POOL CreateThreadpool(
  PVOID reserved
);

Parameter

reserved

Parameter ini dicadangkan dan harus NULL.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan penunjuk ke struktur TP_POOL yang mewakili kumpulan utas yang baru dialokasikan. Aplikasi tidak mengubah anggota struktur ini.

Jika fungsi gagal, fungsi akan mengembalikan NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Setelah membuat kumpulan utas baru, Anda harus memanggil SetThreadpoolThreadMaximum untuk menentukan jumlah maksimum utas yang dapat dialokasikan kumpulan dan SetThreadpoolThreadMinimum untuk menentukan jumlah minimum utas yang tersedia di kumpulan.

Untuk menggunakan kumpulan, Anda harus mengaitkan kumpulan dengan lingkungan panggilan balik. Untuk membuat lingkungan panggilan balik, panggil InitializeThreadpoolEnvironment. Kemudian, panggil SetThreadpoolCallbackPool untuk mengaitkan kumpulan dengan lingkungan panggilan balik.

Untuk merilis kumpulan utas, panggil CloseThreadpool.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.

Contoh

Misalnya, lihat Menggunakan Fungsi Kumpulan Utas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	threadpoolapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll