SetThreadPriority

SetThreadPriority

지정된 스렛드의 상대 우선도를 변경합니다.프로세스의 우선도 클래스와 이 상대 우선도로부터, 스렛드의 기본 우선도가 결정됩니다.

BOOL SetThreadPriority(
    HANDLE hThread,    // 스렛드한돌
    int    nPriority   // 상대 우선도
);

KERNEL32.DLL

인수

hThread

우선도를 변경하는 스렛드의 핸들을 지정합니다.

Windows NT/2000/XP： 이 핸들은 THREAD_SET_INFORMATION 액세스를 가지고 있지 않으면 안됩니다.

nPriority

상대 우선도를 지정합니다.이하의 값의 어느쪽이든을 지정합니다.

치	의미
-15 (THREAD_PRIORITY_IDLE)	프로세스의 우선도 클래스가 REALTIME_PRIORITY_CLASS 때, 스렛드 우선도를 16 (으)로 합니다.그 이외 때는 스렛드 우선도를 1 (으)로 합니다.
-2 (THREAD_PRIORITY_LOWEST)	스렛드 우선도를 프로세스의 우선도 클래스의 통상의 우선도부터 2 낮게 설정합니다.
-1 (THREAD_PRIORITY_BELOW_NORMAL)	스렛드 우선도를 프로세스의 우선도 클래스의 통상의 우선도부터 1 낮게 설정합니다.
0 (THREAD_PRIORITY_NORMAL)	스렛드 우선도를 프로세스의 우선도 클래스의 통상의 우선도로 설정합니다.
1 (THREAD_PRIORITY_ABOVE_NORMAL)	스렛드 우선도를 프로세스의 우선도 클래스의 통상의 우선도부터 1 높게 설정합니다.
2 (THREAD_PRIORITY_HIGHEST)	스렛드 우선도를 프로세스의 우선도 클래스의 통상의 우선도부터 2 높게 설정합니다.
15 (THREAD_PRIORITY_TIME_CRITICAL)	프로세스의 우선도 클래스가 REALTIME_PRIORITY_CLASS 때, 스렛드 우선도를 31 (으)로 합니다.그 이외 때는 스렛드 우선도를 15 (으)로 합니다.

Windows 2000/XP： 이 파라미터에, 상대 우선도를 나타낸다 -7 ~ -3 (와)과 3 ~ 6 의 범위의 정수치를 지정할 수 있습니다.

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

각각의 스렛드는, 프로세스의 우선도 클래스와 스렛드의 상대 우선도로부터 결정되는 기본 우선도를 가집니다.시스템은, 어느 스렛드에 다음의 CPU 의 타임 슬라이스를 줄까를 결정하는데, 모든 실행 가능 스렛드의 기본 우선도를 사용합니다.프로세스의 우선도 클래스는 SetPriorityClass 함수로 지정합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후