IHostCrst::SetSpinCount-Methode

Legt die Anzahl an Spinvorgängen für die aktuelle IHostCrst-Instanz fest.

HRESULT SetSpinCount (
    [in] DWORD dwSpinCount
);

Parameter

dwSpinCount
[in] Die neue Anzahl an Spinvorgängen für die aktuelle IHostCrst-Instanz.

Rückgabewert

HRESULT	Beschreibungen
S_OK	SetSpinCount erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Wenn der durch die aktuelle IHostCrst-Instanz dargestellte kritische Abschnitt auf Mehrprozessorsystemen nicht verfügbar ist, versucht ein aufrufender Thread dwSpinCount Mal die Ausführung, bevor IHostSemaphore::Wait für ein dem kritischen Abschnitt zugeordnetes Semaphore aufgerufen wird. Wenn der kritische Abschnitt während des Spinvorgangs frei wird, vermeidet der aufrufende Thread den Wartevorgang.

Die Syntax von dwSpinCount ist identisch mit der Syntax des gleichnamigen Parameters in der Win32-InitializeCriticalSectionAndSpinCount-Funktion.