SetThreadIdealProcessorEx 함수(processthreadsapi.h)

지정된 스레드에 이상적인 프로세서를 설정하고 필요에 따라 이전의 이상적인 프로세서를 검색합니다.

구문

BOOL SetThreadIdealProcessorEx(
  [in]            HANDLE            hThread,
  [in]            PPROCESSOR_NUMBER lpIdealProcessor,
  [out, optional] PPROCESSOR_NUMBER lpPreviousIdealProcessor
);

매개 변수

[in] hThread

이상적인 프로세서를 설정할 스레드에 대한 핸들입니다. 이 핸들은 THREAD_SET_INFORMATION 액세스 권한으로 만들어졌어야 합니다. 자세한 내용은 스레드 보안 및 액세스 권한을 참조하세요.

[in] lpIdealProcessor

원하는 이상적인 프로세서의 프로세서 번호를 지정하는 PROCESSOR_NUMBER 구조체에 대한 포인터입니다.

[out, optional] lpPreviousIdealProcessor

이전의 이상적인 프로세서를 수신할 PROCESSOR_NUMBER 구조체에 대한 포인터입니다. 이 매개 변수는 lpIdealProcessor 매개 변수와 동일한 메모리 위치를 가리킬 수 있습니다. 이전의 이상적인 프로세서가 필요하지 않은 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 얻으려면 GetLastError를 사용합니다.

설명

스레드 이상적인 프로세서를 지정하면 스케줄러에 스레드의 기본 설정 프로세서에 대한 힌트가 제공됩니다. 스케줄러는 가능한 경우 스레드의 이상적인 프로세서에서 스레드를 실행합니다.

Windows 11 및 Windows Server 2022부터 64개 이상의 프로세서, 프로세스 및 스레드 친화성이 있는 시스템에서는 기본적으로 모든 프로세서 그룹에 걸쳐 시스템의 모든 프로세서에 걸쳐 있습니다. SetThreadIdealProcessorEx는 기본 프로세서를 설정할 때 스레드의 기본 그룹을 기본 프로세서 그룹으로 설정합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT >= 0x0601 설정합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

Windows Phone 8.1: 이 함수는 Windows Phone 8.1 이상에서 Windows Phone 스토어 앱에서 지원됩니다.

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

요구 사항

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

추가 정보

GetThreadIdealProcessorEx

SetThreadIdealProcessor