#include <SFBRingerMgr.h.hpp>

class SFBRingerMgr : public SFBBase;

SFMTYPEDEFWRAPPER(SFBRingerMgr)

[ public ]
SFCError Create(
    WCharConstPtr name          // name of the ringer
    AEESoundPlayerFile format   // ringer format
    SFBAStreamSmpConstRef s     // stream to ringer data
);

[ public ]
SFCError Create(
    SFXWideStringConstRef name   // name of the ringer
    AEESoundPlayerFile format    // ringer format
    SFBAStreamSmpConstRef s      // stream to ringer data
);

[ public ]
SFCError Create(
    SFXWideStringConstRef name   // name of the ringer
    AEESoundPlayerFile format    // ringer format
    SFXStorageConstRef storage   // storage for ringer data
);

[ public ]
SFCError EnumCategoryInit(Void);

[ public ]
Bool EnumNextCategory(
    AEERingerCat* category   // pointer to ringer category information to fill
);

[ public ]
Bool EnumNextRinger(
    AEERingerInfo* info   // pointer to ringer information to fill
);

[ public ]
SFCError EnumRingerInit(Void);

[ public ]
SFCError GetFormats(
    AEESoundPlayerFile* formats   // pointer to a list of formats of size Count * sizeof(AEESoundPlayerFile) 
    SInt32 count                  // number of format entries to fill
);

[ public ]
SInt32 GetNumberFormats(Void);

[ public ]
AEERingerID GetRingerID(
    ACharConstPtr file   // file name of ringer 
);

[ public ]
AEERingerID GetRingerID(
    SFXAnsiStringConstRef file   // file name of ringer 
);

[ public ]
SFCError GetRingerInfo(
    AEERingerID ringerID   // ringer ID 
    AEERingerInfo* info    // pointer to ringer info structure to fill 
);

[ public, static ]
SFBRingerMgrSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBRingerMgrSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

[ public ]
SFCError Play(
    AEERingerID ringerID   // ringer ID to play
    UInt32 pause           // time to pause between re-plays (0 if single play) 
        
);

[ public ]
SFCError PlayEx(
    AEERingerID ringerID      // ringer ID to play
    ACharConstPtr file        // input file name
    SFBAStreamSmpConstRef s   // input stream
    UInt32 pause              // time to pause between re-plays (0 if single play)
);

[ public ]
SFCError PlayEx(
    AEERingerID ringerID         // ringer ID to play
    SFXAnsiStringConstRef file   // input file name
    SFBAStreamSmpConstRef s      // input stream
    UInt32 pause                 // time to pause between re-plays (0 if single play)
);

[ public ]
SFCError PlayEx(
    AEERingerID ringerID         // ringer ID to play
    SFXAnsiStringConstRef file   // input file name
    SFXStorageConstRef storage   // input storage
    UInt32 pause                 // time to pause between re-plays (0 if single play)
);

[ public ]
SFCError PlayFile(
    ACharConstPtr file   // input file name 
    UInt32 pause         // time to pause between re-plays (0 if single play) 
);

[ public ]
SFCError PlayFile(
    SFXAnsiStringConstRef file   // input file name 
    UInt32 pause                 // time to pause between re-plays (0 if single play) 
);

[ public ]
SFCError PlayStream(
    SFBAStreamSmpConstRef s   // input file name
    UInt32 pause              // time to pause between re-plays (0 if single play)
);

[ public ]
SFCError PlayStream(
    SFXStorageConstRef storage   // input file name
    UInt32 pause                 // time to pause between re-plays (0 if single play)
);

[ public ]
Void RegisterNotify(
    PFNRINGEREVENT notify   // pointer to user callback (null to de-register)
    VoidPtr data = null     // pointer to user data for callback. 
                            // if not necessary, it is set to null
);

[ public ]
SFCError Remove(
    AEERingerID ringerID   // ringer id 
);

[ public ]
SFCError SetRinger(
    AEERingerCatID category   // category for the ringer
    AEERingerID ringerID      // id of the ringer 
);

[ public ]
SFCError Stop(Void);