IHostSyncManager::CreateCrstWithSpinCount, méthode

Article
05/10/2023

Crée un objet de section critique avec le nombre de spins pour la synchronisation.

Syntaxe

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

Paramètres

dwSpinCount
[in] Spécifie le nombre de spins pour l’objet de 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` retourné.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	La mémoire était insuffisante pour créer la section critique demandée.

Notes

Un nombre de spins n’est utilisé que sur un système multiprocesseur. Le nombre de spins spécifie le nombre de fois où un thread appelant doit tourner avant d’effectuer 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 spin, le thread appelant évite l’opération d’attente. CreateCrstWithSpinCount reflète la fonction Win32 InitializeCriticalSectionAndSpinCount.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via