GetThreadPriority 함수(processthreadsapi.h)

아티클
03/13/2024

지정된 스레드의 우선 순위 값을 검색합니다. 이 값은 스레드 프로세스의 우선 순위 클래스와 함께 스레드의 기본 우선 순위 수준을 결정합니다.

구문

int GetThreadPriority(
  [in] HANDLE hThread
);

매개 변수

[in] hThread

스레드에 대한 핸들입니다.

핸들에는 THREAD_QUERY_INFORMATION 또는 THREAD_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 스레드 보안 및 액세스 권한을 참조하세요.

Windows Server 2003: 핸들에 THREAD_QUERY_INFORMATION 액세스 권한이 있어야 합니다.

반환 값

함수가 성공하면 반환 값은 스레드의 우선 순위 수준입니다.

함수가 실패하면 반환 값이 THREAD_PRIORITY_ERROR_RETURN. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

Windows Phone 8.1: 이 함수는 항상 THREAD_PRIORITY_NORMAL 반환합니다.

스레드의 우선 순위 수준은 다음 값 중 하나입니다.

반환 코드/값	설명
THREAD_PRIORITY_ABOVE_NORMAL 1	우선 순위 클래스보다 우선 순위가 1포인트 높습니다.
THREAD_PRIORITY_BELOW_NORMAL -1	우선 순위 클래스보다 우선 순위가 1포인트 낮습니다.
THREAD_PRIORITY_HIGHEST 2	우선 순위 클래스보다 우선 순위가 2포인트 높습니다.
THREAD_PRIORITY_IDLE -15	IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS 또는 HIGH_PRIORITY_CLASS 프로세스의 기본 우선 순위는 1이고 REALTIME_PRIORITY_CLASS 프로세스의 기본 우선 순위는 16입니다.
THREAD_PRIORITY_LOWEST -2	우선 순위 클래스보다 우선 순위가 2포인트 낮습니다.
THREAD_PRIORITY_NORMAL 0	우선 순위 클래스의 일반 우선 순위입니다.
THREAD_PRIORITY_TIME_CRITICAL 15	IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS,ABOVE_NORMAL_PRIORITY_CLASS 또는 HIGH_PRIORITY_CLASS 프로세스의 기본 우선 순위 수준은 15이고 REALTIME_PRIORITY_CLASS 프로세스의 경우 기본 우선 순위 수준은 31입니다.

스레드에 REALTIME_PRIORITY_CLASS 기본 클래스가 있는 경우 이 함수는 -7, -6, -5, -4, -3, 3, 4, 5 또는 6 값 중 하나를 반환할 수도 있습니다. 자세한 내용은 예약 우선 순위를 참조하세요.

설명

모든 스레드에는 스레드의 우선 순위 값과 프로세스의 우선 순위 클래스에 따라 결정되는 기본 우선 순위 수준이 있습니다. 운영 체제는 모든 실행 가능한 스레드의 기본 우선 순위 수준을 사용하여 CPU 시간의 다음 조각을 가져오는 스레드를 결정합니다. 스레드는 각 우선 순위 수준에서 라운드 로빈 방식으로 예약되며, 더 높은 수준에서 실행 가능한 스레드가 없는 경우에만 낮은 수준에서 스레드를 예약합니다.

우선 순위 클래스와 스레드 우선 순위 값의 각 조합에 대한 기본 우선 순위 수준을 보여 주는 테이블은 SetPriorityClass 함수를 참조하세요.

Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 스토어 앱에서 지원됩니다.

Windows Phone 8.1:Windows Phone 스토어 앱은 이 함수를 호출할 수 있지만 아무런 효과가 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	processthreadsapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함)
라이브러리	Kernel32.lib; Windows Phone 8.1의 WindowsPhoneCore.lib
DLL	Kernel32.dll; Windows Phone 8.1의 KernelBase.dll