fungsi timeBeginPeriod (timeapi.h)
Fungsi timeBeginPeriod meminta resolusi minimum untuk timer berkala.
Sintaks
MMRESULT timeBeginPeriod(
UINT uPeriod
);
Parameter
uPeriod
Resolusi timer minimum, dalam milidetik, untuk aplikasi atau driver perangkat. Nilai yang lebih rendah menentukan resolusi yang lebih tinggi (lebih akurat).
Nilai kembali
Mengembalikan TIMERR_NOERROR jika berhasil atau TIMERR_NOCANDO jika resolusi yang ditentukan dalam uPeriod di luar rentang.
Keterangan
Panggil fungsi ini segera sebelum menggunakan layanan timer, dan panggil fungsi timeEndPeriod segera setelah Anda selesai menggunakan layanan timer.
Anda harus mencocokkan setiap panggilan ke timeBeginPeriod dengan panggilan ke timeEndPeriod, menentukan resolusi minimum yang sama di kedua panggilan. Aplikasi dapat melakukan beberapa panggilan timeBeginPeriod selama setiap panggilan dicocokkan dengan panggilan ke timeEndPeriod.
Sebelum Windows 10, versi 2004, fungsi ini memengaruhi pengaturan Windows global. Untuk semua proses, Windows menggunakan nilai terendah (yaitu resolusi tertinggi) yang diminta oleh proses apa pun. Dimulai dengan Windows 10, versi 2004, fungsi ini tidak lagi memengaruhi resolusi timer global. Untuk proses yang memanggil fungsi ini, Windows menggunakan nilai terendah (yaitu, resolusi tertinggi) yang diminta oleh proses apa pun. Untuk proses yang belum memanggil fungsi ini, Windows tidak menjamin resolusi yang lebih tinggi daripada resolusi sistem default.
Dimulai dengan Windows 11, jika proses pemilik jendela menjadi sepenuhnya terhambat, diminimalkan, atau tidak terlihat atau tidak terlihat oleh pengguna akhir, Windows tidak menjamin resolusi yang lebih tinggi daripada resolusi sistem default. Lihat SetProcessInformation untuk informasi selengkapnya tentang perilaku ini.
Mengatur resolusi yang lebih tinggi dapat meningkatkan akurasi interval waktu habis dalam fungsi tunggu. Namun, ini juga dapat mengurangi performa sistem secara keseluruhan, karena penjadwal utas beralih tugas lebih sering. Resolusi tinggi juga dapat mencegah sistem manajemen daya CPU memasuki mode hemat daya. Menetapkan resolusi yang lebih tinggi tidak meningkatkan akurasi penghitung kinerja resolusi tinggi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | timeapi.h (termasuk Windows.h) |
| Pustaka | Winmm.lib |
| DLL | Winmm.dll |