IHostSyncManager::CreateCrstWithSpinCount 메서드

2011-08-09

동기화를 위해 회전 횟수를 지정하여 임계 영역 개체를 만듭니다.

HRESULT CreateCrstWithSpinCount (
    [in]  DWORD dwSpinCount,
    [out] IHostCrst** ppCrst
);

매개 변수

dwSpinCount
[in] 임계 영역 개체에 대한 회전 횟수를 지정합니다.
ppCrst
[out] IHostCrst 인스턴스의 주소에 대한 포인터이거나, 임계 영역을 만들 수 없는 경우에는 null입니다.

반환 값

HRESULT	설명
S_OK	CreateCrstWithSpinCount에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자가 잠금을 소유하고 있지 않습니다.
HOST_E_ABANDONED	차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.
E_OUTOFMEMORY	메모리가 부족하여 요청된 임계 영역을 만들 수 없습니다.

설명

회전 횟수는 다중 프로세서 시스템에서만 사용됩니다. 회전 횟수는 호출 스레드에서 사용할 수 없는 임계 영역에 연결된 세마포에 대해 대기 작업을 수행하기 전에 호출 스레드를 회전해야 하는 횟수를 지정합니다. 회전 작업 중 임계 영역이 해제되면 호출 스레드에서 대기 작업이 발생하지 않습니다. CreateCrstWithSpinCount는 Win32 InitializeCriticalSectionAndSpinCount 함수를 미러링합니다.