Fungsi CreateThreadpool (threadpoolapiset.h)
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 |