IHostTask::SetPriority metódus
Azt kéri, hogy a gazdagép módosítsa a szál prioritási szintjét az aktuális IHostTask-példány által képviselt feladathoz.
Szintaxis
HRESULT SetPriority (
[in] int newPriority
);
Paraméterek
newPriority
[in] Egy egész szám, amely az aktuális IHostTask példány által képviselt feladat kért szálprioritási értékét jelöli.
Visszatérési érték
| HRESULT | Description |
|---|---|
| S_OK | SetPriority sikeresen visszaadott. |
| HOST_E_CLRNOTAVAILABLE | A közös nyelvi futtatókörnyezet (CLR) nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást. |
| HOST_E_TIMEOUT | A hívás túllépte az időkorlátot. |
| HOST_E_NOT_OWNER | A hívó nem rendelkezik a zárral. |
| HOST_E_ABANDONED | Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várt rá. |
| E_FAIL | Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza. |
Megjegyzések
A szálak feldolgozási időt kapnak egy ciklikus időszeleteléses rendszer használatával, amely részben egy szál prioritási szintjén alapul. SetPriority lehetővé teszi, hogy a CLR beállítsa az aktuális tevékenység szálprioritási szintjét. Az alábbi newPriority értékek támogatottak.
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL
A CLR akkor hívja meg SetPriority az értéket Thread.Priority , ha a értékét felhasználói kód módosítja. A gazdagépek saját algoritmusokat határozhatnak meg a szálprioritás-hozzárendeléshez, és nyugodtan figyelmen kívül hagyhatják ezt a kérést.
Megjegyzés
SetPriority nem jelenti, hogy a szál prioritási szintje módosult-e. Hívja meg az IHostTask::GetPriority parancsot a tevékenység szálprioritási szintjének értékének meghatározásához.
A szál prioritási szintjeinek értékeit a Win32 SetThreadPriority függvény határozza meg. A szálprioritásról további információt a Windows Platform dokumentációjában talál.
Követelmények
Platformok: Lásd: Rendszerkövetelmények.
Fejléc: MSCorEE.h
Könyvtár: Erőforrásként szerepel a MSCorEE.dll
.NET-keretrendszer verziók: 2.0 óta elérhető
