Método IHostSyncManager::CreateCrstWithSpinCountIHostSyncManager::CreateCrstWithSpinCount Method

Cria um objeto de seção crítica com contagem de rotação para sincronização.Creates a critical section object with spin count for synchronization.

SintaxeSyntax

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

ParâmetrosParameters

dwSpinCount
no Especifica a contagem de rotação para o objeto de seção crítica.[in] Specifies the spin count for the critical section object.

ppCrst
fora Um ponteiro para o endereço de uma instância de IHostCrst ou NULL se a seção crítica não pôde ser criada.[out] A pointer to the address of an IHostCrst instance, or null if the critical section could not be created.

Valor retornadoReturn Value

HRESULTHRESULT DescriçãoDescription
S_OKS_OK CreateCrstWithSpinCount retornado com êxito.CreateCrstWithSpinCount returned successfully.
HOST_E_CLRNOTAVAILABLEHOST_E_CLRNOTAVAILABLE O Common Language Runtime (CLR) não foi carregado em um processo ou o CLR está em um estado no qual não pode executar código gerenciado ou processar a chamada com êxito.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 A chamada atingiu o tempo limite.The call timed out.
HOST_E_NOT_OWNERHOST_E_NOT_OWNER O chamador não possui o bloqueio.The caller does not own the lock.
HOST_E_ABANDONEDHOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou uma fibra bloqueada estava esperando.An event was canceled while a blocked thread or fiber was waiting on it.
E_FAILE_FAIL Ocorreu uma falha catastrófica desconhecida.An unknown catastrophic failure occurred. Quando um método retorna E_FAIL, o CLR não é mais utilizável no processo.When a method returns E_FAIL, the CLR is no longer usable within the process. As chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE.Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORYE_OUTOFMEMORY Não há memória suficiente disponível para criar a seção crítica solicitada.Not enough memory was available to create the requested critical section.

ComentáriosRemarks

Uma contagem de rotação é usada somente em um sistema com vários processadores.A spin count is used only on a multi-processor system. A contagem de rotação especifica o número de vezes que um thread de chamada deve ser girado antes de executar uma operação de espera em um semáforo associado a uma seção crítica indisponível.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. Se a seção crítica for liberada durante a operação de rotação, o thread de chamada evitará a operação de espera.If the critical section becomes free during the spin operation, the calling thread avoids the wait operation. CreateCrstWithSpinCount espelha a função do Win32 InitializeCriticalSectionAndSpinCount .CreateCrstWithSpinCount mirrors the Win32 InitializeCriticalSectionAndSpinCount function.

RequisitosRequirements

Plataformas: confira Requisitos do sistema.Platforms: See System Requirements.

Cabeçalho: MSCorEE. hHeader: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dllLibrary: Included as a resource in MSCorEE.dll

.NET Framework versões:Disponível desde o 2.0Available since 2.0.NET Framework Versions: Disponível desde o 2.0Available since 2.0

Consulte tambémSee also