Fungsi GetThreadPriority (processthreadsapi.h)

Artikel
03/08/2023

Mengambil nilai prioritas untuk utas yang ditentukan. Nilai ini, bersama dengan kelas prioritas proses utas, menentukan tingkat prioritas dasar utas.

Sintaks

int GetThreadPriority(
  [in] HANDLE hThread
);

Parameter

[in] hThread

Handel ke utas.

Handel harus memiliki hak akses THREAD_QUERY_INFORMATION atau THREAD_QUERY_LIMITED_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

Windows Server 2003: Handel harus memiliki hak akses THREAD_QUERY_INFORMATION .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah tingkat prioritas utas.

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

Windows Phone 8.1: Fungsi ini akan selalu mengembalikan THREAD_PRIORITY_NORMAL.

Tingkat prioritas utas adalah salah satu nilai berikut.

Mengembalikan kode/nilai	Deskripsi
THREAD_PRIORITY_ABOVE_NORMAL 1	Prioritas 1 poin di atas kelas prioritas.
THREAD_PRIORITY_BELOW_NORMAL -1	Prioritas 1 poin di bawah kelas prioritas.
THREAD_PRIORITY_HIGHEST 2	Prioritas 2 poin di atas kelas prioritas.
THREAD_PRIORITY_IDLE -15	Prioritas dasar 1 untuk proses IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS, atau HIGH_PRIORITY_CLASS , dan prioritas dasar 16 untuk proses REALTIME_PRIORITY_CLASS .
THREAD_PRIORITY_LOWEST -2	Prioritas 2 poin di bawah kelas prioritas.
THREAD_PRIORITY_NORMAL 0	Prioritas normal untuk kelas prioritas.
THREAD_PRIORITY_TIME_CRITICAL 15	Tingkat prioritas dasar 15 untuk proses IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS, atau HIGH_PRIORITY_CLASS , dan tingkat prioritas dasar 31 untuk proses REALTIME_PRIORITY_CLASS .

Jika utas memiliki kelas dasar REALTIME_PRIORITY_CLASS , fungsi ini juga dapat mengembalikan salah satu nilai berikut: -7, -6, -5, -4, -3, 3, 4, 5, atau 6. Untuk informasi selengkapnya, lihat Prioritas Penjadwalan.

Keterangan

Setiap utas memiliki tingkat prioritas dasar yang ditentukan oleh nilai prioritas utas dan kelas prioritas prosesnya. Sistem operasi menggunakan tingkat prioritas dasar dari semua utas yang dapat dieksekusi untuk menentukan utas mana yang mendapatkan iringan waktu CPU berikutnya. Utas dijadwalkan dengan cara round-robin pada setiap tingkat prioritas, dan hanya ketika tidak ada utas yang dapat dieksekusi pada tingkat yang lebih tinggi akan menjadwalkan utas pada tingkat yang lebih rendah yang berlangsung.

Untuk tabel yang memperlihatkan tingkat prioritas dasar untuk setiap kombinasi kelas prioritas dan nilai prioritas utas, lihat fungsi SetPriorityClass .

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store.

Windows Phone 8.1:Windows Phone Store dapat memanggil fungsi ini tetapi tidak berpengaruh.

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; WindowsPhoneCore.lib di Windows Phone 8.1
DLL	Kernel32.dll; KernelBase.dll pada Windows Phone 8.1