Aracılığıyla paylaş

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 Description
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 Çağıranın kilidi yoktur.
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 kısmen 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.

Not

SetPriority iş parçacığı öncelik düzeyinin değiştirilip değiştirilmediğini bildirmez. 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

Kitaplığı: MSCorEE.dll'da kaynak olarak dahil edilen

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.

  • Last updated on