Metodo IHostCrst::SetSpinCount

Articolo
08/11/2011

Imposta il conteggio rotazioni per l'istanza corrente di IHostCrst.

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Parametri

dwSpinCount
[in] Nuovo numero di iterazioni cicliche per l'istanza corrente di IHostCrst.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	SetSpinCount ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Sui sistemi multiprocessore, se la sezione critica rappresentata dall'istanza corrente di IHostCrst non è disponibile, un thread chiamante esegue il numero di rotazioni specificato in dwSpinCount prima di chiamare IHostSemaphore::Wait in un semaforo associato alla sezione critica. Se la sezione critica diventa disponibile durante l'esecuzione dei cicli, il thread chiamante ignora l'operazione di attesa.

L'utilizzo di dwSpinCount è identico a quello del parametro con lo stesso nome nella funzione InitializeCriticalSectionAndSpinCount Win32.