SetProcessPriorityBoost 함수(processthreadsapi.h)

아티클
03/13/2024

지정된 프로세스의 스레드 우선 순위를 일시적으로 높일 수 있는 시스템 기능을 사용하지 않도록 설정하거나 사용하도록 설정합니다.

구문

BOOL SetProcessPriorityBoost(
  [in] HANDLE hProcess,
  [in] BOOL   bDisablePriorityBoost
);

매개 변수

[in] hProcess

프로세스에 대한 핸들입니다. 이 핸들에는 PROCESS_SET_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

[in] bDisablePriorityBoost

이 매개 변수가 TRUE이면 동적 부스팅을 사용할 수 없습니다. 매개 변수가 FALSE이면 동적 부스팅이 사용됩니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

동적 우선 순위 클래스 중 하나에서 스레드가 실행 중인 경우 시스템은 대기 상태에서 벗어날 때 스레드의 우선 순위를 일시적으로 높입니다. DisablePriorityBoost 매개 변수를 TRUE로 설정하여 SetProcessPriorityBoost를 호출하면 스레드의 우선 순위가 향상되지 않습니다. 이 설정은 모든 기존 스레드 및 이후에 프로세스에서 만든 모든 스레드에 영향을 줍니다. 정상적인 동작을 복원하려면 DisablePriorityBoost가 FALSE로 설정된 SetProcessPriorityBoost를 호출합니다.

요구 사항

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