Delen via

Methode IHostTask::SetPriority

Aanvragen dat de host het prioriteitsniveau van de thread aanpast voor de taak die wordt vertegenwoordigd door het huidige IHostTask-exemplaar .

Syntaxis

HRESULT SetPriority (
    [in] int newPriority
);

Parameterwaarden

newPriority [in] Een geheel getal dat de aangevraagde threadprioriteitswaarde vertegenwoordigt voor de taak die wordt vertegenwoordigd door het huidige IHostTask exemplaar.

Retourwaarde

HRESULT Beschrijving
S_OK SetPriority is geretourneerd.
HOST_E_CLRNOTAVAILABLE De Common Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin de beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER De beller is niet eigenaar van het slot.
HOST_E_ABANDONED Er is een gebeurtenis geannuleerd terwijl een geblokkeerde thread of glasvezel erop wachtte.
E_FAIL Er is een onbekende onherstelbare fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.

Opmerkingen

Threads krijgen verwerkingstijd met behulp van een round robin-systeem dat deels is gebaseerd op het prioriteitsniveau van een thread. SetPriority hiermee kan de CLR dat threadprioriteitsniveau voor de huidige taak instellen. De volgende newPriority waarden worden ondersteund.

  • 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 CLR roept aan SetPriority wanneer de waarde van de Thread.Priority gebruiker wordt gewijzigd door gebruikerscode. Een host kan zijn eigen algoritmen definiëren voor toewijzing van threadprioriteit en kan deze aanvraag negeren.

Opmerking

SetPriority rapporteert niet of het prioriteitsniveau van de thread is gewijzigd. Roep IHostTask::GetPriority aan om de waarde van het prioriteitsniveau van de thread van de taak te bepalen.

Waarden op het niveau van threadprioriteit worden gedefinieerd door de Functie Win32 SetThreadPriority . Zie de windows-platformdocumentatie voor meer informatie over threadprioriteit.

Requirements

Platformen: Zie Systeemvereisten.

Rubriek: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework-versies: Beschikbaar sinds 2.0

Zie ook

  • Last updated on