Método IHostSyncManager::CreateCrstWithSpinCount
Cria um objeto de secção crítico com a contagem de rotações para sincronização.
Sintaxe
HRESULT CreateCrstWithSpinCount (
[in] DWORD dwSpinCount,
[out] IHostCrst** ppCrst
);
Parâmetros
dwSpinCount
[in] Especifica a contagem de rotações para o objeto de secção crítico.
ppCrst
[fora] Um ponteiro para o endereço de uma instância do IHostCrst ou nulo se não for possível criar a secção crítica.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | CreateCrstWithSpinCount devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | Não havia memória suficiente disponível para criar a secção crítica pedida. |
Observações
Uma contagem de rotações é utilizada apenas num sistema com vários processadores. A contagem de rotações especifica o número de vezes que um thread de chamada tem de girar antes de executar uma operação de espera num semáforo associado a uma secção crítica indisponível. Se a secção crítica ficar livre durante a operação de rotação, o thread de chamada evita a operação de espera. CreateCrstWithSpinCount
espelha a função Win32 InitializeCriticalSectionAndSpinCount
.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0