Metode IHostTask::SetPriority

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

Sintaksis

HRESULT SetPriority (
    [in] int newPriority
);

Parameter-parameternya

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

Mengembalikan Nilai

HRESULT Deskripsi
S_OK SetPriority berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam keadaan di mana ia tidak dapat menjalankan kode terkelola atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat utas atau serat yang diblokir sedang menunggu di atasnya.
E_FAIL Kegagalan bencana yang tidak diketahui terjadi. Ketika metode mengembalikan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting mengembalikan HOST_E_CLRNOTAVAILABLE.

Komentar

Utas diberikan waktu pemrosesan menggunakan sistem round-robin yang sebagian didasarkan pada tingkat prioritas utas. SetPriority memungkinkan CLR untuk mengatur tingkat prioritas utas tersebut untuk tugas saat ini. Nilai berikut newPriority 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

CLR memanggil SetPriority ketika nilai Thread.Priority dimodifikasi oleh kode pengguna. Host dapat menentukan algoritmanya sendiri untuk penetapan prioritas utas, dan bebas untuk mengabaikan permintaan ini.

Nota

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

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

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Perpustakaan: Disertakan sebagai sumber daya dalam MSCorEE.dll

Versi .NET Framework: Tersedia sejak 2.0

Baca juga

  • Last updated on