IHostSyncManager::CreateCrstWithSpinCount — Metoda
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