IHostCrst::SetSpinCount, méthode

Article
08/10/2011

Définit le compteur de rotations pour l'instance IHostCrst actuelle.

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Paramètres

dwSpinCount
[in] Nouveau compteur de rotations pour l'instance IHostCrst actuelle.

Valeur de retour

HRESULT	Description
S_OK	SetSpinCount a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

Sur les systèmes multiprocesseurs, si la section critique représentée par l'instance IHostCrst actuelle n'est pas disponible, un thread appelant tourne dwSpinCount fois avant d'appeler IHostSemaphore::Wait sur un sémaphore associé à la section critique. Si la section critique se libère pendant l'opération de rotation, le thread appelant évite l'opération d'attente.

L'utilisation de dwSpinCount est identique à celle du paramètre du même nom dans la fonction InitializeCriticalSectionAndSpinCount Win32.