CreateThreadpool 함수(threadpoolapiset.h)
콜백을 실행할 새 스레드 풀을 할당합니다.
구문
PTP_POOL CreateThreadpool(
PVOID reserved
);
매개 변수
reserved
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
반환 값
함수가 성공하면 새로 할당된 스레드 풀을 나타내는 TP_POOL 구조체에 대한 포인터를 반환합니다. 애플리케이션은 이 구조체의 멤버를 수정하지 않습니다.
함수가 실패하면 NULL을 반환합니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.
설명
새 스레드 풀을 만든 후 SetThreadpoolThreadMaximum 을 호출하여 풀에서 할당할 수 있는 최대 스레드 수를 지정하고 SetThreadpoolThreadMinimum 을 호출하여 풀에서 사용할 수 있는 최소 스레드 수를 지정해야 합니다.
풀을 사용하려면 풀을 콜백 환경과 연결해야 합니다. 콜백 환경을 만들려면 InitializeThreadpoolEnvironment를 호출합니다. 그런 다음 SetThreadpoolCallbackPool 을 호출하여 풀을 콜백 환경과 연결합니다.
스레드 풀을 해제하려면 CloseThreadpool을 호출합니다.
이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0600 이상으로 정의합니다.
예제
예제는 스레드 풀 함수 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | threadpoolapiset.h(Windows 7, Windows Server 2008 Windows Server 2008 R2의 Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |