IHostSyncManager::CreateCrstWithSpinCount (Método)

Artículo
08/10/2011

Crea un objeto de sección crítica con recuento circular para la sincronización.

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

Parámetros

dwSpinCount
[in] Especifica el recuento circular para el objeto de sección crítica.
ppCrst
[out] Puntero a la dirección de una instancia de IHostCrst, o bien, null si no se ha podido crear la sección crítica.

Valor devuelto

HRESULT	Descripción
S_OK	CreateCrstWithSpinCount finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	No había suficiente memoria disponible para crear la sección crítica solicitada.

Comentarios

Un recuento circular sólo se utiliza en un sistema con varios procesadores. El recuento circular especifica el número de veces que un subproceso que llama debe girar antes de realizar una operación de espera en un semáforo que está asociado a una sección crítica no disponible. Si la sección crítica se libera durante la operación circular, el subproceso que realiza la llamada evita la operación de espera. CreateCrstWithSpinCount refleja la función InitializeCriticalSectionAndSpinCount de Win32.