CComMultiThreadModel::AutoCriticalSection

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CComMultiThreadModel の使用中に、typedef 名 AutoCriticalSection は CComAutoCriticalSection クラスを参照します。このクラスには、クリティカルセクションオブジェクトの所有権を取得および解放するためのメソッドが用意されています。

typedef CComAutoCriticalSection AutoCriticalSection;

解説

CComSingleThreadModel および CComMultiThreadModelNoCS にも、AutoCriticalSection の定義が含まれています。次の表は、スレッド化モデルクラスと、AutoCriticalSection によって参照されるクリティカルセクションクラスとの関係を示しています。

定義されているクラス	参照されるクラス
CComMultiThreadModel	CComCriticalSection
CComSingleThreadModel	CComFakeCriticalSection
CComMultiThreadModelNoCS	CComFakeCriticalSection

AutoCriticalSection の他にも、typedef 名 CriticalSection を使用できます。CRT スタートアップコードを削除する場合は、グローバルオブジェクトまたは静的クラスメンバで AutoCriticalSection を指定しないでください。

使用例

次のコードは CComObjectRootEx をモデルに作成されています。スレッド環境で使用する AutoCriticalSection の例を示しています。

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;
};

次の各表に InternalAddRef メソッドおよび Lock メソッドの結果を示します。アプリケーションで使われる ThreadModel テンプレートのパラメータとスレッド化モデルに応じて、2 つの表に分けて示します。

ThreadModel = CComObjectThreadModel

メソッド	シングルスレッドまたはアパートメントスレッド	フリースレッド
InternalAddRef	インクリメントは、スレッドセーフではありません。	インクリメントは、スレッドセーフです。
Lock	ロックするクリティカルセクションがないので、何の処理も行いません。	クリティカルセクションはロックされます。

ThreadModel = CComObjectThreadModel::ThreadModelNoCS

メソッド	シングルスレッドまたはアパートメントスレッド	フリースレッド
InternalAddRef	インクリメントは、スレッドセーフではありません。	インクリメントは、スレッドセーフです。
Lock	ロックするクリティカルセクションがないので、何の処理も行いません。	ロックするクリティカルセクションがないので、何の処理も行いません。