Método de IHostSyncManager::CreateCrstWithSpinCount

Artigo
08/08/2011

Cria um objeto de seção crítica com a contagem de rotação para sincronização.

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

Parâmetros

dwSpinCount
[in] Especifica a contagem de rotação do objeto de seção crítica.
ppCrst
[out] Um ponteiro para o endereço de um IHostCrst da instância ou nulo se a seção crítica não pôde ser criada.

Valor de retorno

HRESULT	Descrição
S_OK	CreateCrstWithSpinCountretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória disponível suficiente para criar a seção crítica solicitada.

Comentários

Uma contagem de rotação é usada somente em um sistema de multiprocessador. A contagem de rotações Especifica o número de vezes que um segmento de chamada deve girar antes de executar uma operação de esperar um semáforo que está associado uma seção crítica disponível. Se a seção crítica fique livre durante a operação de rotação, o thread de chamada evita a operação de esperar. CreateCrstWithSpinCountespelha o Win32 InitializeCriticalSectionAndSpinCount função.