BltModule.h

Go to the documentation of this file.

/*****************************************************************
|
|   BlueTune - Module Interface
|
|   (c) 2002-2006 Gilles Boccon-Gibod
|   Author: Gilles Boccon-Gibod (bok@bok.net)
|
 ****************************************************************/
#ifndef _BLT_MODULE_H_
#define _BLT_MODULE_H_

/*----------------------------------------------------------------------
|   includes
+---------------------------------------------------------------------*/
#include "Atomix.h"
#include "BltTypes.h"
#include "BltCore.h"

/*----------------------------------------------------------------------
|   types
+---------------------------------------------------------------------*/
typedef enum {
    BLT_MODULE_PARAMETERS_TYPE_MEDIA_NODE_CONSTRUCTOR
} BLT_ModuleParametersType;

typedef unsigned char BLT_ModuleId[16];

typedef struct {
    BLT_CString  name;
    BLT_ModuleId id;
    BLT_Flags    flags;
} BLT_ModuleInfo;

typedef struct {
    /* interfaces */
    ATX_IMPLEMENTS(BLT_Module);
    ATX_IMPLEMENTS(ATX_Referenceable);

    /* members */
    BLT_Cardinal   reference_count;
    BLT_ModuleInfo info;
} BLT_BaseModule;

/*----------------------------------------------------------------------
|   constants
+---------------------------------------------------------------------*/
#define BLT_MODULE_PROBE_MATCH_DEFAULT 0
#define BLT_MODULE_PROBE_MATCH_MIN     1
#define BLT_MODULE_PROBE_MATCH_LOW     64
#define BLT_MODULE_PROBE_MATCH_MEDIUM  128
#define BLT_MODULE_PROBE_MATCH_HIGH    192
#define BLT_MODULE_PROBE_MATCH_MAX     253
#define BLT_MODULE_PROBE_MATCH_EXACT   254
#define BLT_MODULE_PROBE_MATCH_FORCE   255

/*----------------------------------------------------------------------
|   error codes
+---------------------------------------------------------------------*/
#define BLT_ERROR_NO_MATCHING_MODULE (BLT_ERROR_BASE_MODULE - 0)

/*----------------------------------------------------------------------
|   BLT_Module interface
+---------------------------------------------------------------------*/
ATX_BEGIN_INTERFACE_DEFINITION(BLT_Module)
    BLT_Result (*GetInfo)(BLT_Module* self, BLT_ModuleInfo* info);

    BLT_Result (*Attach)(BLT_Module* self, BLT_Core* core);

    BLT_Result (*CreateInstance)(BLT_Module*              self,
                                 BLT_Core*                core,
                                 BLT_ModuleParametersType parameters_type,
                                 BLT_AnyConst             parameters,
                                 const ATX_InterfaceId*   interface_id,
                                 ATX_Object**             object);

    BLT_Result (*Probe)(BLT_Module*              self,
                        BLT_Core*                core,
                        BLT_ModuleParametersType parameters_type,
                        BLT_AnyConst             parameters,
                        BLT_Cardinal*            match);
ATX_END_INTERFACE_DEFINITION

/*----------------------------------------------------------------------
|   convenience macros
+---------------------------------------------------------------------*/
#define BLT_Module_GetInfo(object, info) \
ATX_INTERFACE(object)->GetInfo(object, info)

#define BLT_Module_Attach(object, core) \
ATX_INTERFACE(object)->Attach(object, core)

#define BLT_Module_CreateInstance(object, core, parameters_type, parameters, interface_id, new_object) \
ATX_INTERFACE(object)->CreateInstance(object,               \
                                      core,                 \
                                      parameters_type,      \
                                      parameters,           \
                                      interface_id,         \
                                      new_object)

#define BLT_Module_Probe(object, core, type, query, match) \
ATX_INTERFACE(object)->Probe(object, core, type, query, match)

/*----------------------------------------------------------------------
|   base methods
+---------------------------------------------------------------------*/
#if defined(__cplusplus)
extern "C" {
#endif

BLT_Result
BLT_BaseModule_Construct(BLT_BaseModule* self, 
                         BLT_CString     name, 
                         BLT_ModuleId    id,
                         BLT_Flags       flags);

BLT_Result
BLT_BaseModule_Destruct(BLT_BaseModule* self);

BLT_Result
BLT_BaseModule_Create(BLT_CString                name, 
                      BLT_ModuleId               id,
                      BLT_Flags                  flags,
                      const BLT_ModuleInterface* module_interface,
                      const ATX_ReferenceableInterface* referenceable_interface,
                      BLT_Module**               object);

BLT_Result
BLT_BaseModule_Destroy(BLT_BaseModule* self);

BLT_DIRECT_METHOD
BLT_BaseModule_GetInfo(BLT_Module* self, BLT_ModuleInfo* info);

BLT_DIRECT_METHOD
BLT_BaseModule_Attach(BLT_Module* self, BLT_Core* core);

#if defined (__cplusplus)
}
#endif

/*----------------------------------------------------------------------
|   template macros
+---------------------------------------------------------------------*/
#define BLT_MODULE_IMPLEMENT_SIMPLE_CONSTRUCTOR(_module_class,      \
                                                _module_name,       \
                                                _module_flags)      \
static BLT_Result                                                   \
_module_class##_Create(BLT_Module** object)                         \
{                                                                   \
    _module_class* module;                                          \
                                                                    \
    /* allocate memory for the object */                            \
    module = (_module_class*)                                       \
        ATX_AllocateZeroMemory(sizeof(_module_class));              \
                                                                    \
    /* construct the inherited object */                            \
    BLT_BaseModule_Construct(&ATX_BASE(module, BLT_BaseModule),     \
                             _module_name,                          \
                             NULL,                                  \
                             _module_flags);                        \
                                                                    \
    /* setup interfaces */                                          \
    ATX_SET_INTERFACE_EX(module, _module_class,                     \
                        BLT_BaseModule, BLT_Module);                \
    ATX_SET_INTERFACE_EX(module, _module_class,                     \
                         BLT_BaseModule, ATX_Referenceable);        \
    *object = &ATX_BASE_EX(module, BLT_BaseModule, BLT_Module);     \
    return BLT_SUCCESS;                                             \
}

#endif /* _BLT_MODULE_H_ */