IHostCrst::SetSpinCount (Método)

Artículo
08/10/2011

Establece el recuento circular para la instancia actual de IHostCrst.

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Parámetros

dwSpinCount
[in] Nuevo recuento circular para la instancia de IHostCrst actual.

Valor devuelto

HRESULT	Descripción
S_OK	SetSpinCount 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.

Comentarios

En sistemas multiprocesador, si la sección crítica representada por la instancia de IHostCrst actual no está disponible, un subproceso que realiza la llamada da dwSpinCount vueltas antes de llamar a IHostSemaphore::Wait en un semáforo asociado a la sección crítica. 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.

El uso de dwSpinCount es idéntico al uso del parámetro homónimo de la funciónInitializeCriticalSectionAndSpinCount de Win32.