다음을 통해 공유


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

참고 항목

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

스레드 풀