Fungsi CreateThreadpoolTimer (threadpoolapiset.h)
Membuat objek timer baru.
Sintaks
PTP_TIMER CreateThreadpoolTimer(
[in] PTP_TIMER_CALLBACK pfnti,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parameter
[in] pfnti
Fungsi panggilan balik untuk memanggil setiap kali objek timer kedaluwarsa. Untuk detailnya, lihat TimerCallback.
[in, out, optional] pv
Data opsional yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik.
[in, optional] pcbe
Struktur TP_CALLBACK_ENVIRON yang menentukan lingkungan untuk menjalankan panggilan balik. Fungsi InitializeThreadpoolEnvironment mengembalikan struktur ini.
Jika parameter ini NULL, panggilan balik dijalankan di lingkungan panggilan balik default. Untuk informasi selengkapnya, lihat InitializeThreadpoolEnvironment.
Menampilkan nilai
Jika fungsi berhasil, fungsi mengembalikan penunjuk ke struktur TP_TIMER yang menentukan objek timer. Aplikasi tidak mengubah anggota struktur ini.
Jika fungsi gagal, fungsi akan mengembalikan NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Untuk mengatur objek timer, panggil fungsi SetThreadpoolTimer .
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.
Contoh
Misalnya, lihat Menggunakan Fungsi Kumpulan Utas.
Persyaratan
| 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 |