Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mengaktifkan timer yang dapat ditunggu yang ditentukan. Ketika waktu jatuh tempo tiba, timer disinyalir dan utas yang mengatur timer memanggil rutinitas penyelesaian opsional.
Sintaksis
BOOL SetWaitableTimer(
[in] HANDLE hTimer,
[in] const LARGE_INTEGER *lpDueTime,
[in] LONG lPeriod,
[in, optional] PTIMERAPCROUTINE pfnCompletionRoutine,
[in, optional] LPVOID lpArgToCompletionRoutine,
[in] BOOL fResume
);
Parameter
[in] hTimer
Handel ke objek timer. Fungsi CreateWaitableTimer atau OpenWaitableTimer mengembalikan handel ini.
Handel harus memiliki hak akses TIMER_MODIFY_STATE. Untuk informasi selengkapnya, lihat Keamanan Objek Sinkronisasi dan Hak Akses.
[in] lpDueTime
Waktu setelah status timer diatur ke sinyal, dalam 100 interval nanodetik. Gunakan format yang dijelaskan oleh struktur
Windows XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 dan Windows Server 2008 R2: Jika waktu relatif ditentukan, timer mencakup waktu yang dihabiskan dalam status berdaya rendah. Misalnya, timer terus menghitung mundur saat komputer sedang tidur.
Windows 8 dan yang lebih baru, Windows Server 2012 dan yang lebih baru: Jika waktu relatif ditentukan, timer tidak menyertakan waktu yang dihabiskan dalam status berdaya rendah. Misalnya, timer tidak melanjutkan penghitungan mundur saat komputer sedang tidur.
[in] lPeriod
Periode timer, dalam milidetik. Jika lPeriod nol, timer akan diberi sinyal sekali. Jika lPeriod lebih besar dari nol, timer berkala. Timer berkala secara otomatis diaktifkan kembali setiap kali periode berlalu, hingga timer dibatalkan menggunakan fungsi
[in, optional] pfnCompletionRoutine
Penunjuk ke rutinitas penyelesaian opsional. Rutinitas penyelesaian adalah fungsi jenis yang ditentukan aplikasi PTIMERAPCROUTINE untuk dijalankan ketika timer diberi sinyal. Untuk informasi selengkapnya tentang fungsi panggilan balik timer, lihat TimerAPCProc. Untuk informasi selengkapnya tentang APC dan utas kumpulan utas, lihat Komentar.
[in, optional] lpArgToCompletionRoutine
Penunjuk ke struktur yang diteruskan ke rutinitas penyelesaian.
[in] fResume
Jika parameter ini TRUE, memulihkan sistem dalam mode konservasi daya yang ditangguhkan saat status timer diatur ke sinyal. Jika tidak, sistem tidak dipulihkan. Jika sistem tidak mendukung pemulihan, panggilan berhasil, tetapi GetLastError mengembalikan ERROR_NOT_SUPPORTED.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.
Komentar
Timer awalnya tidak aktif. Untuk mengaktifkan timer, panggil SetWaitableTimer. Jika timer sudah aktif saat Anda memanggil SetWaitableTimer, timer dihentikan, maka timer diaktifkan kembali. Menghentikan timer dengan cara ini tidak mengatur status timer ke sinyal, sehingga utas yang diblokir dalam operasi tunggu pada timer tetap diblokir. Namun, itu membatalkan rutinitas penyelesaian yang tertunda.
Ketika waktu jatuh tempo yang ditentukan tiba, timer menjadi tidak aktif, dan APC opsional diantrekan ke utas yang mengatur timer jika tidak ada APC yang belum diantrekan.
Status timer diatur ke sinyal, timer diaktifkan kembali menggunakan periode yang ditentukan, dan utas yang mengatur timer memanggil rutinitas penyelesaian ketika memasuki status tunggu yang dapat diingat.
Untuk informasi selengkapnya, lihat QueueUserAPC. Perhatikan bahwa APC tidak berfungsi serta mekanisme sinyal lainnya untuk utas kumpulan utas karena sistem mengontrol masa pakai utas kumpulan utas, sehingga mungkin utas dihentikan sebelum pemberitahuan dikirimkan. Alih-alih menggunakan parameter pfnCompletionRoutine
Jika utas yang mengatur timer berakhir dan ada rutinitas penyelesaian terkait, timer dibatalkan. Namun, keadaan timer tetap tidak berubah. Jika tidak ada rutinitas penyelesaian, maka mengakhiri utas tidak berpengaruh pada timer.
Ketika timer pengaturan ulang manual diatur ke status yang disinyalir, timer tetap dalam status ini hingga SetWaitableTimer dipanggil untuk mengatur ulang timer. Akibatnya, timer reset manual berkala diatur ke status yang disinyalir ketika waktu jatuh tempo awal tiba dan tetap diberi sinyal hingga diatur ulang. Ketika timer sinkronisasi diatur ke status yang disinyalir, timer tetap dalam status ini hingga utas menyelesaikan operasi tunggu pada objek timer.
Jika waktu sistem disesuaikan, waktu jatuh tempo dari timer absolut yang luar biasa disesuaikan.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0400 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Untuk menggunakan timer untuk menjadwalkan peristiwa untuk jendela, gunakan fungsi
API yang menangani timer menggunakan berbagai jam perangkat keras yang berbeda. Jam ini mungkin memiliki resolusi yang secara signifikan berbeda dari yang Anda harapkan: beberapa mungkin diukur dalam milidetik (bagi mereka yang menggunakan chip timer berbasis RTC), dengan yang diukur dalam nanodetik (bagi mereka yang menggunakan penghitung ACPI atau TSC). Anda dapat mengubah resolusi API Anda dengan panggilan ke fungsi timeBeginPerio d
Contoh
Untuk contoh yang menggunakanSetWaitableTimer
Persyaratan
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| server minimum yang didukung |
Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Platform Target |
Windows |
| Header |
synchapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Pustaka |
Kernel32.lib |
| DLL |
Kernel32.dll |
Lihat juga
Fungsi Sinkronisasi
TimerAPCProc
Objek Timer yang Dapat Ditunda