Fungsi SetThreadPriorityBoost (processthreadsapi.h)

Artikel
03/01/2024

Menonaktifkan atau memungkinkan kemampuan sistem untuk meningkatkan prioritas utas untuk sementara waktu.

Sintaks

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

Parameter

[in] hThread

Handel ke utas yang prioritasnya akan ditingkatkan. Handel harus memiliki hak akses THREAD_SET_INFORMATION atau THREAD_SET_LIMITED_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

Windows Server 2003 dan Windows XP: Handel harus memiliki hak akses THREAD_SET_INFORMATION .

[in] bDisablePriorityBoost

Jika parameter ini TRUE, peningkatan dinamis dinonaktifkan. Jika parameter false, peningkatan dinamis diaktifkan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Ketika utas berjalan di salah satu kelas prioritas dinamis, sistem untuk sementara meningkatkan prioritas utas ketika diambil dari status tunggu. Jika SetThreadPriorityBoost dipanggil dengan parameter DisablePriorityBoost yang diatur ke TRUE, prioritas utas tidak ditingkatkan. Untuk memulihkan perilaku normal, panggil SetThreadPriorityBoost dengan DisablePriorityBoost diatur ke FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.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