Bagikan melalui

IHostTask::SetPriority Method

Meminta agar host menyesuaikan tingkat prioritas utas untuk tugas yang diwakili oleh instans IHostTask saat ini.

Sintaks

HRESULT SetPriority (  
    [in] int newPriority  
);

Parameter

newPriority
[in] Bilangan bulat yang mewakili nilai prioritas utas yang diminta untuk tugas yang diwakili oleh instans IHostTask saat ini.

Tampilkan Nilai

HRESULT Deskripsi
S_OK SetPriority berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.

Keterangan

Utas diberikan waktu pemrosesan menggunakan sistem round-robin yang sebagian didasarkan pada tingkat prioritas utas. SetPriority memungkinkan runtime bahasa umum untuk mengatur tingkat prioritas utas tersebut untuk tugas saat ini. Nilai newPriority berikut didukung.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

Runtime bahasa umum memanggil SetPriority ketika nilai Thread.Priority diubah oleh kode pengguna. Host dapat menentukan algoritmanya sendiri untuk penugasan prioritas utas, dan dapat mengabaikan permintaan ini.

Catatan

SetPriority tidak melaporkan apakah tingkat prioritas utas diubah. Panggil IHostTask::GetPriority untuk menentukan nilai tingkat prioritas utas tugas.

Nilai tingkat prioritas utas ditentukan oleh fungsi SetThreadPriority Win32. Untuk informasi selengkapnya tentang prioritas utas, lihat dokumentasi Windows Platform.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on