Método IHostCrst::SetSpinCount

Artigo
08/25/2010

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

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Parâmetros

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

Valor de retorno

HRESULT	Descrição
S_OK	SetSpinCount retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

Em sistemas multiprocessadores, se a seção crítica representado pela corrente IHostCrst instância não estiver disponível, um segmento de chamada gira dwSpinCount vezes antes de ligar IHostSemaphore::Wait em um sinal associado com a seção crítica. Se a seção crítica ficar disponível durante a operação de rotação, o thread de chamada evita a operação de espera.

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