Klasa CComMultiThreadModel

CComMultiThreadModel Zapewnia bezpieczne wątkowo metody inkrementacji i dekrementacji wartości zmiennej.

Składnia

class CComMultiThreadModel

Elementy członkowskie

Definicje typów publicznych

Metody publiczne

Uwagi

Zazwyczaj używasz CComMultiThreadModel za pomocą jednej z dwóch nazw typedef, CComObjectThreadModel lub CComGlobalsThreadModel. Klasa, do którego odwołuje się każda typedef z nich, zależy od używanego modelu wątkowego, jak pokazano w poniższej tabeli:

S= CComSingleThreadModel; M= CComMultiThreadModel

CComMultiThreadModel sam definiuje trzy typedef nazwy. AutoCriticalSection i CriticalSection klasy referencyjne, które zapewniają metody uzyskiwania i zwalniania własności sekcji krytycznej. ThreadModelNoCS references, klasa [CComMultiThreadModelNoCS(ccommultithreadmodelnocs-class.md).

Wymagania

Nagłówek: atlbase.h

CComMultiThreadModel::AutoCriticalSection

W przypadku używania metody CComMultiThreadModeltypedef nazwa AutoCriticalSection odwołuje się do klasy CComAutoCriticalSection, która udostępnia metody uzyskiwania i zwalniania własności obiektu sekcji krytycznej.

typedef CComAutoCriticalSection AutoCriticalSection;

Uwagi

CComSingleThreadModel i CComMultiThreadModelNoCS zawierają również definicje dla elementu AutoCriticalSection. W poniższej tabeli przedstawiono relację między klasą modelu wątkowania a klasą sekcji krytycznej przywołyną przez :AutoCriticalSection

Oprócz AutoCriticalSectionfunkcji można użyć typedef nazwy CriticalSection. Nie należy określać AutoCriticalSection w obiektach globalnych lub statycznych składowych klas, jeśli chcesz wyeliminować kod uruchamiania CRT.

Przykład

Poniższy kod jest modelowany po CComObjectRootEx i demonstruje AutoCriticalSection użycie w środowisku wątkowym.

template<class ThreadModel>
class CMyAutoCritClass
{
public:
   typedef ThreadModel _ThreadModel;
   typedef typename _ThreadModel::AutoCriticalSection _CritSec;

   CMyAutoCritClass() : m_dwRef(0) {}

   ULONG InternalAddRef()
   {
      return _ThreadModel::Increment(&m_dwRef);
   }
   ULONG InternalRelease()
   {
      return _ThreadModel::Decrement(&m_dwRef);
   }
   void Lock() { m_critsec.Lock( ); }
   void Unlock() { m_critsec.Unlock(); }

private:
   _CritSec m_critsec;
   LONG m_dwRef;

W poniższych tabelach przedstawiono wyniki InternalAddRef metod i Lock w zależności od ThreadModel parametru szablonu i modelu wątkowania używanego przez aplikację:

ThreadModel = CComObjectThreadModel

ThreadModel = CComObjectThreadModel::ThreadModelNoCS

CComMultiThreadModel::CriticalSection

W przypadku używania CComMultiThreadModelmetody typedef nazwa CriticalSection odwołuje się do klasy CComCriticalSection, która udostępnia metody uzyskiwania i zwalniania własności obiektu sekcji krytycznej.

typedef CComCriticalSection CriticalSection;

Uwagi

CComSingleThreadModel i CComMultiThreadModelNoCS zawierają również definicje dla elementu CriticalSection. W poniższej tabeli przedstawiono relację między klasą modelu wątkowania a klasą sekcji krytycznej przywołyną przez :CriticalSection

Oprócz CriticalSectionfunkcji można użyć typedef nazwy AutoCriticalSection. Nie należy określać AutoCriticalSection w obiektach globalnych lub statycznych składowych klas, jeśli chcesz wyeliminować kod uruchamiania CRT.

Przykład

Zobacz CComMultiThreadModel::AutoCriticalSection.

CComMultiThreadModel::D ecrement

Ta funkcja statyczna wywołuje funkcję Win32 InterlockedDecrement, która dekrementuje wartość zmiennej wskazywanej przez p.

static ULONG WINAPI Decrement(LPLONG p) throw ();

Parametry

p
[in] Wskaźnik do zmiennej, która ma zostać zdekrementowana.

Wartość zwracana

Jeśli wynik dekrementacji wynosi 0, Decrement zwraca wartość 0. Jeśli wynik dekrementu jest niezerowy, zwracana wartość jest również niezerowa, ale może nie być równa wyniku dekrementacji.

Uwagi

InterlockedDecrement zapobiega jednoczesnemu używaniu tej zmiennej więcej niż jeden wątek.

CComMultiThreadModel::Increment

Ta funkcja statyczna wywołuje funkcję Win32 InterlockedIncrement, co zwiększa wartość zmiennej wskazywanej przez p.

static ULONG WINAPI Increment(LPLONG p) throw ();

Parametry

p
[in] Wskaźnik do zmiennej, która ma być zwiększana.

Wartość zwracana

Jeśli wynik przyrostu wynosi 0, Increment zwraca wartość 0. Jeśli wynik przyrostu jest niezerowy, zwracana wartość jest również niezerowa, ale może nie być równa wynikowi przyrostu.

Uwagi

InterlockedIncrement zapobiega jednoczesnemu używaniu tej zmiennej więcej niż jeden wątek.

CComMultiThreadModel::ThreadModelNoCS

W przypadku używania metody CComMultiThreadModeltypedef nazwa ThreadModelNoCS odwołuje się do klasy CComMultiThreadModelNoCS.

typedef CComMultiThreadModelNoCS ThreadModelNoCS;

Uwagi

CComMultiThreadModelNoCS Zapewnia bezpieczne wątkowo metody inkrementacji i dekrementacji zmiennej; nie zawiera jednak sekcji krytycznej.

CComSingleThreadModel oraz CComMultiThreadModelNoCS zawiera definicje dla elementu ThreadModelNoCS. W poniższej tabeli przedstawiono relację między klasą modelu wątkowania a klasą przywołyną przez ThreadModelNoCS:

Przykład

Zobacz CComMultiThreadModel::AutoCriticalSection.

Zobacz też

Klasa CComSingleThreadModel
Klasa CComAutoCriticalSection
Klasa CComCriticalSection
Omówienie klasy