1e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent/* 2e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. 3e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * 4e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * Use of this source code is governed by a BSD-style license 5e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * that can be found in the LICENSE file in the root of the source 6e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * tree. An additional intellectual property rights grant can be found 7e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * in the file PATENTS. All contributing project authors may 8e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent * be found in the AUTHORS file in the root of the source tree. 9e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent */ 10e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 11e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent#ifndef WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CRITICAL_SECTION_WRAPPER_H_ 12e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent#define WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CRITICAL_SECTION_WRAPPER_H_ 13e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 14e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent// If the critical section is heavily contended it may be beneficial to use 15e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent// read/write locks instead. 16e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 17e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent#include "common_types.h" 18e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 19e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentnamespace webrtc { 20e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentclass CriticalSectionWrapper 21e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent{ 22e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentpublic: 23e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent // Factory method, constructor disabled 24e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent static CriticalSectionWrapper* CreateCriticalSection(); 25e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 26e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent virtual ~CriticalSectionWrapper() {} 27e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 28e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent // Tries to grab lock, beginning of a critical section. Will wait for the 29e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent // lock to become available if the grab failed. 30e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent virtual void Enter() = 0; 31e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 32e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent // Returns a grabbed lock, end of critical section. 33e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent virtual void Leave() = 0; 34e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent}; 35e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 36c55a96383497a772a307b346368133960b02ad03Eric Laurent// RAII extension of the critical section. Prevents Enter/Leave mismatches and 37e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent// provides more compact critical section syntax. 38e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentclass CriticalSectionScoped 39e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent{ 40e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentpublic: 41c55a96383497a772a307b346368133960b02ad03Eric Laurent // Deprecated, don't add more users of this constructor. 42c55a96383497a772a307b346368133960b02ad03Eric Laurent // TODO(mflodman) Remove this version of the constructor when no one is 43c55a96383497a772a307b346368133960b02ad03Eric Laurent // using it any longer. 44c55a96383497a772a307b346368133960b02ad03Eric Laurent explicit CriticalSectionScoped(CriticalSectionWrapper& critsec) 45c55a96383497a772a307b346368133960b02ad03Eric Laurent : _ptrCritSec(&critsec) 46e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent { 47e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent _ptrCritSec->Enter(); 48e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent } 49e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 50c55a96383497a772a307b346368133960b02ad03Eric Laurent explicit CriticalSectionScoped(CriticalSectionWrapper* critsec) 51c55a96383497a772a307b346368133960b02ad03Eric Laurent : _ptrCritSec(critsec) 52c55a96383497a772a307b346368133960b02ad03Eric Laurent { 53c55a96383497a772a307b346368133960b02ad03Eric Laurent _ptrCritSec->Enter(); 54c55a96383497a772a307b346368133960b02ad03Eric Laurent } 55c55a96383497a772a307b346368133960b02ad03Eric Laurent 56e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent ~CriticalSectionScoped() 57e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent { 58e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent if (_ptrCritSec) 59e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent { 60e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent Leave(); 61e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent } 62e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent } 63e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 64e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurentprivate: 65e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent void Leave() 66e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent { 67e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent _ptrCritSec->Leave(); 68e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent _ptrCritSec = 0; 69e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent } 70e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent 71e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent CriticalSectionWrapper* _ptrCritSec; 72e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent}; 73e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent} // namespace webrtc 74e48d5845c8b35de2ab73ea055c18a61fa3a9f0beEric Laurent#endif // WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CRITICAL_SECTION_WRAPPER_H_ 75