IHostSyncManager::CreateCrstWithSpinCount, méthode

Article
08/10/2011

Crée un objet section critique avec compteur de rotations pour la synchronisation.

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

Paramètres

dwSpinCount
[in] Spécifie le compteur de rotations pour l'objet section critique.
ppCrst
[out] Pointeur vers l'adresse d'une instance IHostCrst, ou null si la section critique n'a pas pu être créée.

Valeur de retour

HRESULT	Description
S_OK	CreateCrstWithSpinCount 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.
E_OUTOFMEMORY	Mémoire disponible insuffisante pour créer la section critique demandée.

Notes

Un compteur de rotations est uniquement utilisé sur un système multiprocesseur. Le compteur de rotations spécifie le nombre de fois qu'un thread appelant doit effectuer une rotation avant d'exécuter une opération d'attente sur un sémaphore associé à une section critique non disponible. Si la section critique se libère pendant l'opération de rotation, le thread appelant évite l'opération d'attente. CreateCrstWithSpinCount reflète la fonction Win32 InitializeCriticalSectionAndSpinCount.