Bagikan melalui


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

Lihat juga

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Kumpulan Utas