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