Метод IHostSyncManager::CreateCrstWithSpinCountIHostSyncManager::CreateCrstWithSpinCount Method

Создает объект критической секции с количеством счетчиков для синхронизации.Creates a critical section object with spin count for synchronization.

СинтаксисSyntax

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

ПараметрыParameters

dwSpinCount
окне Указывает счетчик счетчиков для объекта критической секции.[in] Specifies the spin count for the critical section object.

ppCrst
заполняет Указатель на адрес экземпляра IHostCrst или значение null, если не удалось создать критическую секцию.[out] A pointer to the address of an IHostCrst instance, or null if the critical section could not be created.

Возвращаемое значениеReturn Value

HRESULTHRESULT Описание:Description
S_OKS_OK CreateCrstWithSpinCount успешно возвращено.CreateCrstWithSpinCount returned successfully.
HOST_E_CLRNOTAVAILABLEHOST_E_CLRNOTAVAILABLE Среда CLR не была загружена в процесс, или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или успешно обработать вызов.The common language runtime (CLR) has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.
HOST_E_TIMEOUTHOST_E_TIMEOUT Время ожидания вызова истекло.The call timed out.
HOST_E_NOT_OWNERHOST_E_NOT_OWNER Вызывающий объект не владеет блокировкой.The caller does not own the lock.
HOST_E_ABANDONEDHOST_E_ABANDONED Событие было отменено, пока заблокированный поток или волокно ожидают его.An event was canceled while a blocked thread or fiber was waiting on it.
E_FAILE_FAIL Произошла неизвестная фатальная ошибка.An unknown catastrophic failure occurred. Когда метод возвращает E_FAIL, среда CLR больше не может использоваться в процессе.When a method returns E_FAIL, the CLR is no longer usable within the process. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE.Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORYE_OUTOFMEMORY Недостаточно свободной памяти для создания запрошенной критической секции.Not enough memory was available to create the requested critical section.

RemarksRemarks

Счетчик прокрутки используется только в многопроцессорной системе.A spin count is used only on a multi-processor system. Число счетчиков указывает, сколько раз вызывающий поток должен прокрутить перед выполнением операции ожидания семафора, связанного с недоступным критическим разделом.The spin count specifies the number of times a calling thread must spin before it performs a wait operation on a semaphore that is associated with an unavailable critical section. Если критическая секция будет свободна во время операции Spin, вызывающий поток не будет выполнять операцию ожидания.If the critical section becomes free during the spin operation, the calling thread avoids the wait operation. CreateCrstWithSpinCount отражает функцию Win32 InitializeCriticalSectionAndSpinCount .CreateCrstWithSpinCount mirrors the Win32 InitializeCriticalSectionAndSpinCount function.

ТребованияRequirements

Платформы: см. раздел Требования к системе.Platforms: See System Requirements.

Заголовок: MSCorEE. hHeader: MSCorEE.h

Библиотека: Включается в качестве ресурса в MSCorEE.dllLibrary: Included as a resource in MSCorEE.dll

Платформа .NET Framework версии:Доступно с версии 2.0Available since 2.0.NET Framework Versions: Доступно с версии 2.0Available since 2.0

См. такжеSee also