Udostępnij za pośrednictwem

IHostTask::SetPriority — Metoda

  • Artykuł

Żąda, aby host dostosować poziom priorytetu wątku dla zadania reprezentowanego przez bieżące wystąpienie IHostTask .

Składnia

HRESULT SetPriority (  
    [in] int newPriority  
);

Parametry

newPriority
[w] Liczba całkowita reprezentująca żądaną wartość priorytetu wątku dla zadania reprezentowanego przez bieżące IHostTask wystąpienie.

Wartość zwracana

HRESULT Opis
S_OK SetPriority zwrócono pomyślnie.
HOST_E_CLRNOTAVAILABLE Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.
HOST_E_TIMEOUT Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

Wątki są przyznawane czas przetwarzania przy użyciu systemu działania okrężnego, który jest częściowo oparty na poziomie priorytetu wątku. SetPriority umożliwia clR ustawienie tego poziomu priorytetu wątku dla bieżącego zadania. Obsługiwane są następujące newPriority wartości.

  • 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 wywołuje wywołanie SetPriority , gdy wartość elementu Thread.Priority jest modyfikowana przez kod użytkownika. Host może zdefiniować własne algorytmy przypisania priorytetu wątku i może zignorować to żądanie.

Uwaga

SetPriority nie zgłasza, czy poziom priorytetu wątku został zmieniony. Wywołaj metodę IHostTask::GetPriority , aby określić wartość poziomu priorytetu wątku zadania.

Wartości na poziomie priorytetu wątku są definiowane przez funkcję Win32 SetThreadPriority . Aby uzyskać więcej informacji na temat priorytetu wątku, zobacz dokumentację platformy systemu Windows.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

.NET Framework wersje: dostępne od wersji 2.0

Zobacz też