SetCriticalSectionSpinCount 함수(synchapi.h)

아티클
02/05/2024

지정된 중요 섹션의 스핀 수를 설정합니다. 회전은 스레드가 잠긴 중요한 섹션을 획득하려고 하면 스레드가 루프에 들어가 잠금이 해제되었는지 확인하고 잠금이 해제되지 않으면 스레드가 절전 모드로 이동한다는 것을 의미합니다.

구문

DWORD SetCriticalSectionSpinCount(
  [in, out] LPCRITICAL_SECTION lpCriticalSection,
  [in]      DWORD              dwSpinCount
);

매개 변수

[in, out] lpCriticalSection

중요한 섹션 개체에 대한 포인터입니다.

[in] dwSpinCount

임계 영역 개체의 스핀 수입니다. 단일 프로세서 시스템에서는 스핀 수가 무시되고 중요한 섹션 스핀 수가 0으로 설정됩니다. 다중 프로세서 시스템에서 중요한 섹션을 사용할 수 없는 경우 호출 스레드는 중요 섹션과 연결된 세마포에서 대기 작업을 수행하기 전에 dwSpinCount 시간을 회전합니다. 스핀 작업 중에 임계 영역이 해제되면 호출 스레드는 대기 작업을 방지합니다.

반환 값

함수는 중요 섹션에 대한 이전 스핀 수를 반환합니다.

설명

단일 프로세스의 스레드는 상호 배제 동기화에 중요한 섹션 개체를 사용할 수 있습니다. 프로세스는 CRITICAL_SECTION 형식의 변수를 선언하여 수행할 수 있는 중요한 섹션 개체에 사용되는 메모리를 할당합니다. 중요한 섹션을 사용하기 전에 프로세스의 일부 스레드는 개체를 초기 화하기 위해 InitializeCriticalSection 또는 InitializeCriticalSectionAndSpinCount 함수를 호출해야 합니다. 그런 다음 SetCriticalSectionSpinCount 함수를 호출하여 스핀 수를 수정할 수 있습니다.

스핀 수는 높은 수준의 경합을 경험할 수 있는 짧은 기간의 중요한 섹션에 유용합니다. SMP 시스템의 애플리케이션에 힙에서 메모리를 지속적으로 할당하고 해제하는 두 개 또는 세 개의 스레드가 있는 최악의 시나리오를 고려합니다. 애플리케이션은 중요한 섹션을 사용하여 힙을 직렬화합니다. 최악의 경우 중요한 섹션에 대한 경합은 일정하며 각 스레드는 WaitForSingleObject 함수를 처리 집약적으로 호출합니다. 그러나 스핀 수가 제대로 설정된 경우 호출 스레드는 경합이 발생할 때 WaitForSingleObject를 즉시 호출하지 않습니다. 대신 호출 스레드는 스핀 작업 중에 릴리스되는 경우 중요한 섹션의 소유권을 획득할 수 있습니다.

짧은 기간의 중요한 섹션에 대해 작은 스핀 수를 선택하여 성능을 크게 향상시킬 수 있습니다. 힙 관리자는 힙당 중요한 섹션에 대해 약 4000의 스핀 수를 사용합니다. 이는 거의 모든 최악의 시나리오에서 뛰어난 성능과 확장성을 제공합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT0x0403 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항

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