1 /*---------------------------------------------------------------------------*
2   Project:  NintendoWare
3   File:     snd_HardwareChannelManager.h
4 
5   Copyright (C)2009-2011 Nintendo/HAL Laboratory, Inc.  All rights reserved.
6 
7   These coded instructions, statements, and computer programs contain proprietary
8   information of Nintendo and/or its licensed developers and are protected by
9   national and international copyright laws. They may not be disclosed to third
10   parties or copied or duplicated in any form, in whole or in part, without the
11   prior written consent of Nintendo.
12 
13   The content herein is highly confidential and should be handled accordingly.
14 
15   $Revision: 31311 $
16  *---------------------------------------------------------------------------*/
17 
18 #ifndef NW_SND_HARDWARE_CHANNEL_MANAGER_H_
19 #define NW_SND_HARDWARE_CHANNEL_MANAGER_H_
20 
21 #include <nw/ut/ut_LinkList.h>  // for ut::LinkList
22 #include <nw/snd/snd_HardwareChannel.h>
23 
24 namespace nw {
25 namespace snd {
26 namespace internal {
27 namespace driver {
28 
29 class HardwareChannelManager
30 {
31 public:
32     static const int CHANNEL_COUNT_MARGIN = 4;  // RVL は計96ch中、マージン16だった
33     typedef
34         ut::LinkList< HardwareChannel, offsetof(HardwareChannel, m_LinkNode) >
35         HardwareChannelList;
36 
37     static HardwareChannelManager& GetInstance();
38     static bool IsChannelPlay( u8 ch_no );
39 
40     unsigned long GetRequiredMemSize( int hardwareChannelCount );
41     void Initialize( void* mem, unsigned long memSize );
42     void Finalize();
43 
44     HardwareChannel* AllocHardwareChannel(  // NW4R AcquireAxVoice 相当
45         u32 priority,
46         HardwareChannel::HardwareChannelCallback callback,
47         void* callbackData
48     );
49     void FreeHardwareChannel( HardwareChannel* hardwareChannel );
50     void ReserveForFreeHardwareChannel( HardwareChannel* hardwareChannel );
51 
52     void FreeAllReservedHardwareChannel();
53 
GetHardwareChannelCount()54     int GetHardwareChannelCount() const { return m_HardwareChannelCount; }
GetActiveVoiceCount()55     unsigned long GetActiveVoiceCount() const { return m_ActiveList.GetSize(); }
GetFreeVoiceCount()56     unsigned long GetFreeVoiceCount() const { return m_FreeList.GetSize(); }
GetFreeReservedVoiceCount()57     unsigned long GetFreeReservedVoiceCount() const { return m_FreeReservedList.GetSize(); }
58 
59 private:
60     HardwareChannelManager();
61     void OnInitialize();
62 
63     HardwareChannel* Alloc();
64     void Free( HardwareChannel* hardwareChannel );
65     void ReserveForFree( HardwareChannel* hardwareChannel );
66 
67     HardwareChannelList m_ActiveList;   // プライオリティの低い順
68     HardwareChannelList m_FreeList;
69     HardwareChannelList m_FreeReservedList;
70 
71     int  m_HardwareChannelCount;
72     bool m_IsInitialized;
73 };
74 
75 } // namespace nw::snd::internal::driver
76 } // namespace nw::snd::internal
77 } // namespace nw::snd
78 } // namespace nw
79 
80 #endif /* NW_SND_HARDWARE_CHANNEL_MANAGER_H_ */
81 
82