기술 자료: 94804 - 마지막 검토: 2003년 5월 5일 월요일 - 수정: 2.0

INFO: 스레드 로컬 저장소 개요

시스템 팁본 문서의 내용은 귀하가 사용하는 운영 체제와 다른 운영 체제에 해당합니다. 문서 내용 중 귀하와 관련 없는 부분은 표시되지 않습니다.

이 문서는 이전에 다음 ID로 출판되었음: KR94804

TLS(스레드 로컬 저장소)는 주어진 프로세스에 있는 각 스레드에서 스레드 전용 데이터를 저장할 수 있도록 위치를 주는 방법입니다.

TLS를 위한 함수에는 TlsAlloc(), TlsGetValue(), TlsSetValue() 및 TlsFree()등이 있습니다. 이러한 함수는 프로세스에 있는 각 스레드에 대한 저장 영역을 참조하는 TLS 인덱스를 관리합니다. 주어진 인덱스는 자신을 할당한 프로세스 내에서만 유효합니다.

Visual C++ 컴파일러는 아래와 같은 대체 구문을 지원합니다.

_declspec( thread )

이 구문은 이러한 API를 직접 호출하는 대신 사용할 수 있습니다. 자세한 내용은 VC++ "언어 및 런타임 도움말" 도움말 파일에 있는 _declspec의 설명을 참조하십시오.

위로 가기

추가 정보

TlsAlloc()에 대한 호출은 전역 TLS 인덱스를 반환합니다. 이 하나의 TLS 인덱스는 자신을 할당한 프로세스 내의 모든 스레드에 대해 유효합니다. 따라서 전역 또는 정적 변수로 저장해야 합니다.

스레드 로컬 저장소는 다음과 같이 동작합니다. TlsAlloc()이 호출되면 프로세스 내의 모든 스레드는 자신에게 예약된 고유한 ULONG_PTR 크기의 공간을 갖습니다. 이 공간은 스택 공간 내에 있지만 구현 방식에 따라 달라집니다. 그러나 하나의 TLS 인덱스만 반환됩니다. 프로세스에 있는 각 스레드는 이러한 단일의 TLS 인덱스를 사용하여 TlsAlloc()이 예약한 고유 공간을 참조합니다.

이러한 이유로 인해, TlsAlloc()은 대개 한 번만 호출됩니다. 이 함수는 DLL_PROCESS_ATTACH( 프로세스의 첫번째 스레드가 DLL에 연결되어 있음)와 DLL_THREAD_ATTACH(프로세스의 다음 스레드가 연결되어 있음)를 구별할 수 있기 때문에 DLL에서 유용하게 사용할 수 있습니다. 예를 들어, 첫번째 스레드가 TlsAlloc()를 호출하고 전역 변수 또는 정적 변수로 TLS 인덱스를 저장하고 DLL에 연결되어 있는 다른 모든 스레드는 해당 로컬 저장 공간에 엑세스하기 위해서 전역 변수를 참조합니다.

일반적으로 하나의 TLS 인덱스만으로 충분하지만 프로세스는 TLS_MINIMUM_AVAILABLE 인덱스까지 TLS 인덱스를 가질 수 있습니다(64개 이상까지 가질 수 있습니다.)

일단 TLS 인덱스가 할당되어 저장되면 프로세스 내의 스레드는 이 인덱스를 사용하여 자신의 저장 공간에 있는 값을 설정하거나 얻을 수 있습니다. 스레드는 자신의 로컬 저장소에 ULONG_PTR 크기의 값을 저장할 수 있습니다(예: ULONG_PTR 값, 동적으로 할당된 메모리에 대한 포인터 등). 이러한 목적으로 TlsSetValue() 및 TlsGetValue() API가 사용됩니다.

프로세스는 TLS 인덱스의 사용이 끝나면 TlsFree()를 사용하여 이 인덱스를 해제합니다. 그러나 프로세스에 있는 스레드가 자신의 로컬 저장 공간 내에 동적으로 할당된 메모리에 대한 포인터를 저장했으면 TLS 인덱스를 해제하기 전에 메모리에 대한 포인터를 얻어서 메모리를 해제해야 합니다. 그렇지 않으면 메모리가 손실됩니다.

자세한 내용은 "Win32 Programmer's Reference"의 "Processes and Threads"에 있는 "Using Thread Local Storage"을 참조하십시오.

위로 가기

예제

프로세스 내의 스레드 A가 TlsAlloc()을 호출하고 전역 변수 TlsIndex에 반환된 인덱스를 저장합니다.

TlsIndex = TlsAlloc();

그런 다음 스레드 A가 100바이트의 동적 메모리를 할당하여 로컬 저장소에 저장합니다.

TlsSetValue( TlsIndex, malloc(100) );

스레드 A가 스레드 B를 만들고 TisIndex가 참조하는 로컬 저장 공간에 윈도우에 대한 핸들을 저장합니다

TlsSetValue( TlsIndex, (LPVOID)hSomeWindow );

TlsIndex는 스레드 B가 사용할 때와 스레드 A가 사용할 때 서로 다른 위치를 참조합니다. 각 스레드는 TlsIndex에 있는 같은 값이 참조하는 고유 위치를 가지고 있습니다.

스레드 B는 특별히 로컬 저장소에서 값을 해제하지 않아도 되므로 안전하게 종료할 수 있습니다.

그러나 스레드 A가 종료되기 전에 로컬 저장소에 동적으로 할당된 메모리를 먼저 해제해야 합니다.

free( TlsGetValue( TlsIndex ) );

그런 다음 TLS 인덱스를 해제합니다.

   if ( !TlsFree( TlsIndex ) )
      // TlsFree() failed.Handle error.

위로 가기

본 문서의 정보는 다음의 제품에 적용됩니다.

Microsoft Win32 Application Programming Interface?을(를) 다음과 함께 사용했을 때

Microsoft Windows NT Advanced Server 3.1
Microsoft Windows NT 4.0
Microsoft Windows NT 3.51 Service Pack 5
Microsoft Windows NT 4.0
Microsoft Windows 2000 Standard Edition

위로 가기

kbinfo kbthread kbkernbase kbwinos2000 kbgrpkernbase kbntos400 kbntos350 kbwinos95 kbntos351 kbntos310 KB94804

위로 가기

This site in other countries/regions:

INFO: 스레드 로컬 저장소 개요

이 페이지에서

요약

추가 정보

예제

본 문서의 정보는 다음의 제품에 적용됩니다.

키워드:?

이 문서에 대한 의견 보내기

추가 지원 사이트

커뮤니티

기술 자료 번역