IHostSyncManager::CreateCrstWithSpinCount 方法

2011-08-12

创建具有自旋计数的临界区对象以进行同步。

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 函数的反映。