IHostTask::SetPriority Yöntemi

Konağın, geçerli IHostTask örneği tarafından temsil edilen görev için iş parçacığı öncelik düzeyini ayarlamasını istemektedir.

Sözdizimi

HRESULT SetPriority (
    [in] int newPriority
);

Parametreler

newPriority [in] Geçerli IHostTask örnek tarafından temsil edilen görev için istenen iş parçacığı öncelik değerini temsil eden bir tamsayı.

Dönüş Değeri

HRESULT Açıklama
S_OK SetPriority başarıyla döndürüldü.
HOST_E_CLRNOTAVAILABLE Ortak dil çalışma zamanı (CLR) bir işleme yüklenmemiş veya CLR yönetilen kodu çalıştıramadığı veya çağrıyı başarıyla işleyemediği bir durumda.
HOST_E_TIMEOUT Arama zaman aşımına uğradı.
HOST_E_NOT_OWNER Arayan, kilidin sahibi değil.
HOST_E_ABANDONED Engellenen bir iş parçacığı veya fiber beklerken bir olay iptal edildi.
E_FAIL Bilinmeyen bir yıkıcı hata oluştu. Bir yöntem E_FAIL döndürdüğünde, CLR artık işlem içinde kullanılamaz. Barındırma yöntemlerine yapılan sonraki çağrılar HOST_E_CLRNOTAVAILABLE döndürür.

Açıklamalar

İş parçacıklarına, bir iş parçacığının öncelik düzeyini temel alan hepsini bir kez deneme sistemi kullanılarak işleme süresi verilir. SetPriority CLR'nin geçerli görev için iş parçacığı öncelik düzeyini ayarlamasına izin verir. Aşağıdaki newPriority değerler desteklenir.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

değeri kullanıcı kodu tarafından değiştirildiğinde Thread.Priority CLR çağrılarıSetPriority. Bir konak, iş parçacığı öncelik ataması için kendi algoritmalarını tanımlayabilir ve bu isteği yoksayabilir.

Uyarı

SetPriority iş parçacığı öncelik düzeyinin değiştirilip değiştirilmediğini raporlamaz. Görevin iş parçacığı öncelik düzeyinin değerini belirlemek için IHostTask::GetPriority çağrısı yapın.

İş parçacığı öncelik düzeyi değerleri Win32 SetThreadPriority işlevi tarafından tanımlanır. İş parçacığı önceliği hakkında daha fazla bilgi için Windows Platformu belgelerine bakın.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kütüphane: MSCorEE.dll'da kaynak olarak dahil

.NET Framework Sürümleri: 2.0'dan itibaren kullanılabilir

Ayrıca bakınız

  • Last updated on