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.

Szemantika

HRESULT SetPriority (
    [in] int newPriority
);

Paraméterek

newPriority [in] Egész szám, amely az aktuális IHostTask példány által képviselt tevékenység kért szálprioritási értékét jelöli.

Visszaadott érték

HRESULT Leírás
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. A metódusok későbbi hívásai HOST_E_CLRNOTAVAILABLE térnek 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. A következő 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 a hívásokat SetPriority , ha a felhasználó kódja módosítja az Thread.Priority értékeket. A gazdagépek saját algoritmusokat határozhatnak meg a szálprioritás-hozzárendeléshez, és szabadon 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 függvényt a tevékenység szálprioritási szintjének értékének meghatározásához.

A szál prioritási szintű értékeit a Win32 SetThreadPriority függvény határozza meg. A szál prioritásával kapcsolatos további információkért tekintse meg a Windows Platform dokumentációját.

Követelmények

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszerverziók: 2.0 óta elérhető

Lásd még

  • Last updated on