Método de IHostCrst::SetSpinCount

Artigo
08/08/2011

Define a contagem de rotação atual IHostCrst instância.

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Parâmetros

dwSpinCount
[in] A nova contagem de rotação atual IHostCrst instância.

Valor de retorno

HRESULT	Descrição
S_OK	SetSpinCountretornado 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.

Comentários

Em sistemas multiprocessadores, se a seção crítica representado pela atual IHostCrst instância não estiver disponível, um segmento de chamada gira dwSpinCount vezes antes de chamar IHostSemaphore::Wait em um semáforo associado com a seção crítica. 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.

O uso de dwSpinCount é idêntica ao uso do parâmetro do mesmo nome no Win32 InitializeCriticalSectionAndSpinCount função.