Udostępnij za pośrednictwem

IHostSyncManager::CreateCrstWithSpinCount — Metoda

  • Artykuł

Tworzy obiekt sekcji krytycznej z liczbą spinów na potrzeby synchronizacji.

Składnia

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

Parametry

dwSpinCount
[in] Określa liczbę spinów dla obiektu sekcji krytycznej.

ppCrst
[out] Wskaźnik do adresu wystąpienia IHostCrst lub wartość null, jeśli nie można utworzyć sekcji krytycznej.

Wartość zwracana

HRESULT Opis
S_OK CreateCrstWithSpinCount zwrócone pomyślnie.
HOST_E_CLRNOTAVAILABLE Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub clR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.
HOST_E_TIMEOUT Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Za mało pamięci, aby utworzyć żądaną sekcję krytyczną.

Uwagi

Liczba obrotów jest używana tylko w systemie z wieloma procesorami. Liczba obrotów określa, ile razy wątek wywołujący musi zostać uruchomiony, zanim wykona operację oczekiwania na semafor skojarzony z niedostępną sekcją krytyczną. Jeśli sekcja krytyczna stanie się bezpłatna podczas operacji uruchamiania, wątek wywołujący unika operacji oczekiwania. CreateCrstWithSpinCount dubluje funkcję Win32 InitializeCriticalSectionAndSpinCount .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też