开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > DVD > 查看源码
machblue_tv_defines.h
资源名称：ST_5105DTV.rar　[点击查看]
上传用户：fy98168
上传日期：2015-06-26
资源大小：13771k
文件大小：44k
源码类别：

DVD

开发平台：

C/C++

machblue_tv_defines.h：源码内容
  1. /*-----------------------------------------------------------------------------
  2.  | @(#) machblue_tv_defines.h
  3.  |
  4.  |  JSWF: The Portable SWF Engine For Embedded Devices,
  5.  |  Copyright (c) 2002-2006, BlueStreak Technology Inc., All Rights Reserved.
  6.  |
  7.  +----------------------------------------------------------------------------*/
  10. #ifndef _MACHBLUE_TV_DEFINES_H_
  11. #define _MACHBLUE_TV_DEFINES_H_
  14. /*----------------------------------------------------------
  15.  | Include definition below this line
  16.  +----------------------------------------------------------*/
  18. #include "machblue_tv_customer.h"
  19. #include "machblue_defines.h"
  21. #ifdef __cplusplus
  23. extern "C" {
  25. #endif /* __cplusplus */
  27. /*----------------------------------------------------------
  28.  | Macro definition below this line
  29.  +----------------------------------------------------------*/
  31. /** Machblue TV ALL Service List ID */
  32. #define MB_TV_SVL_ALL_ID            0
  36. /** Machblue TV status argument (mb_error_t). 
  37.  * @see MB_TV_NR_SERVICE_LISTS_GET 
  38.  * @see mb_error_t
  39.  */
  40. #define MB_TV_STATUS_ARG(args)                  ((args)->arg[0].l) 
  42. /** Machblue TV list of service lists argument (mb_tv_service_list_t *).
  43.  * @see MB_TV_NR_SERVICE_LISTS_GET
  44.  * @see mb_tv_service_list_t
  45.  */
  46. #define MB_TV_SVL_LIST_ARG(args)                ((args)->arg[1].vp) 
  48. /** Machblue TV service list argument (mb_tv_service_list_t).
  49.  * @see MB_TV_NR_SVL_CHANGED
  50.  * @see mb_tv_service_list_t
  51.  */
  52. #define MB_TV_SVL_ARG(args)                     ((args)->arg[1].l) 
  54. /** Machblue TV list of services argument (mb_tv_service_t *).
  55.  * @see MB_TV_NR_SERVICES_GET 
  56.  * @see mb_tv_service_t
  57.  */
  58. #define MB_TV_SERVICE_LIST_ARG(args)            ((args)->arg[1].vp) 
  60. /** Machblue TV service pointer argument (mb_tv_service_t *).
  61.  * @see MB_TV_NR_SERVICE_GET_FROM_URL 
  62.  * @see mb_tv_service_t
  63.  */
  64. #define MB_TV_SERVICE_PTR_ARG(args)             ((args)->arg[1].vp) 
  66. /** Machblue TV service argument (mb_tv_service_t).
  67.  * @see MB_TV_NR_CURRENT_EVENT_CHANGED 
  68.  * @see mb_tv_service_t
  69.  */
  70. #define MB_TV_SERVICE_ARG(args)                 ((args)->arg[0].l) 
  72. /** Machblue TV event argument (mb_tv_event_t).
  73.  * @see MB_TV_NR_SERVICE_CURRENT_EVENT_GET 
  74.  * @see mb_tv_event_t
  75.  */
  76. #define MB_TV_EVENT_ARG(args)                   ((args)->arg[1].l) 
  78. /** Machblue TV event schedule argument (mb_tv_event_schedule_t).
  79.  * @see MB_TV_NR_SERVICE_EVENT_SCHEDULE_GET
  80.  * @see mb_tv_event_schedule_t
  81.  */
  82. #define MB_TV_EVS_ARG(args)                     ((args)->arg[1].l) 
  84. /** Machblue list of events argument (mb_tv_event_t *).
  85.  * @see TV MB_TV_NR_EVS_EVENTS_GET 
  86.  * @see mb_tv_event_t
  87.  */
  88. #define MB_TV_EVENT_LIST_ARG(args)              ((args)->arg[1].vp) 
  90. /** Machblue TV list of service contexts argument (mb_tv_service_context_t *).
  91.  * @see MB_TV_NR_SERVICE_CONTEXTS_GET  
  92.  * @see mb_tv_service_context_t
  93.  */
  94. #define MB_TV_SVC_LIST_ARG(args)                ((args)->arg[1].vp) 
  96. /** Machblue TV list of stream info argument (mb_tv_stream_info_t *).
  97.  * @see MB_TV_NR_STREAMS_INFO_GET
  98.  * @see mb_tv_stream_info_t
  99.  */
  100. #define MB_TV_STREAM_INFO_LIST_ARG(args)        ((args)->arg[1].vp) 
  102. /** Machblue TV command argument (mb_tv_trick_play_cmd_t)
  103.  * @see MB_TV_NR_TRICK_PLAY  
  104.  * @see mb_tv_trick_play_cmd_t
  105.  */
  106. #define MB_TV_TRICK_PLAY_CMD_ARG(args)          ((args)->arg[1].l) 
  108. /** Machblue TV command parameter argument (long)
  109.  * @see MB_TV_NR_TRICK_PLAY  
  110.  */
  111. #define MB_TV_TRICK_PLAY_PARAM_ARG(args)        ((args)->arg[2].l)
  113. /** Machblue TV list of recordings argument (mb_tv_recording_t).
  114.  * @see MB_TV_NR_RECORDINGS_GET  
  115.  * @see mb_tv_recording_t
  116.  */
  117. #define MB_TV_RECORDING_LIST_ARG(args)          ((args)->arg[1].vp) 
  119. /** Machblue TV recording argument (mb_tv_recording_t).
  120.  * @see MB_TV_NR_EVENT_RECORD 
  121.  * @see mb_tv_recording_t
  122.  */
  123. #define MB_TV_RECORDING_PTR_ARG(args)           ((args)->arg[1].vp) 
  125. /** Machblue TV recording argument (mb_tv_recording_t).
  126.  * @see MB_TV_NR_RECORDING_CHANGED
  127.  * @see mb_tv_recording_t
  128.  */
  129. #define MB_TV_RECORDING_ARG(args)               ((args)->arg[0].l)
  131. /** Machblue TV service context argument (mb_tv_service_context_t).
  132.  * @see MB_TV_NR_SERVICE_SELECTED  
  133.  * @see mb_tv_service_context_t
  134.  */
  135. #define MB_TV_SERVICE_CONTEXT_ARG(args)         ((args)->arg[0].vp) 
  137. /** Machblue TV service argument (mb_tv_service_t).
  138.  * @see MB_TV_NR_SERVICE_SELECTED  
  139.  * @see mb_tv_service_t
  140.  */
  141. #define MB_TV_SELECTED_SERVICE_ARG(args)        ((args)->arg[1].vp) 
  143. /** Machblue TV service error argument (long int, manufacturer specific).
  144.  * @see MB_TV_NR_SERVICE_ERROR  
  145.  */
  146. #define MB_TV_SERVICE_ERROR_ARG(args)           ((args)->arg[2].l) 
  148. /** Machblue TV stream controller argument (mb_tv_stream_controller_t).
  149.  * @see MB_TV_NR_STREAM_ENABLED  
  150.  * @see mb_tv_stream_controller_t
  151.  */
  152. #define MB_TV_STREAM_CONTROLLER_ARG(args)       ((args)->arg[0].vp) 
  154. /** Machblue TV stream type argument (mb_tv_stream_type_t).
  155.  * @see MB_TV_NR_STREAM_ENABLED 
  156.  * @see mb_tv_stream_type_t
  157.  */
  158. #define MB_TV_STREAM_TYPE_ARG(args)             ((args)->arg[1].l) 
  160. /** Machblue TV stream error argument (long int, manufacturer specific).
  161.  * @see MB_TV_NR_STREAM_ERROR 
  162.  */
  163. #define MB_TV_STREAM_ERROR_ARG(args)            ((args)->arg[2].l) 
  165. /** Machblue TV source id argument (int).
  166.  * @see MB_TV_NR_SIGNAL_LOST  
  167.  */
  168. #define MB_TV_SOURCE_ID_ARG(args)               ((args)->arg[1].l) 
  170. /** Machblue TV conflict argument (mb_tv_conflict_t).
  171.  * @see MB_TV_NR_RECORDER_CONFLICT 
  172.  * @see mb_tv_conflict_t
  173.  */
  174. #define MB_TV_CONFLICT_ARG(args)                ((args)->arg[0].vp) 
  176. /** Machblue TV conflict recording list argument (mb_tv_recording_t *).
  177.  * @see MB_TV_NR_RECORDER_CONFLICT 
  178.  * @see mb_tv_recording_t
  179.  */
  180. #define MB_TV_CONFLICT_RECORDING_LIST_ARG(args) ((args)->arg[1].vp) 
  182. /** Machblue TV conditional access error argument (long int, manufacturer specific).
  183.  * @see MB_TV_NR_CA_ERROR (long)
  184.  */
  185. #define MB_TV_CA_ERROR_ARG(args)                ((args)->arg[1].l) 
  187. /** Machblue TV vod session handle argument (mb_tv_vod_session_t).
  188.  * @see MB_TV_NR_VOD_SESSION_CONNECTED
  189.  * @see mb_tv_vod_session_t
  190.  */
  191. #define MB_TV_VOD_SESSION_ARG(args)             ((args)->arg[0].l) 
  193. /** Machblue TV vod session error argument (long int, manufacturer specific).
  194.  * @see MB_TV_NR_VOD_SESSION_ERROR 
  195.  */
  196. #define MB_TV_VOD_SESSION_ERROR_ARG(args)       ((args)->arg[1].l) 
  198. /** Machblue TV playback position value argument in nano-seconds (mb_system_time_t *).
  199.  * @see MB_TV_NR_PLAYBACK_POSITION_NOTIFY
  200.  * @see mb_system_time_t 
  201.  */
  202. #define MB_TV_PB_POSITION_VALUE_ARG(args)       ((args)->arg[1].vp)
  204. /** Machblue TV playback buffer side argument  (mb_tv_playback_side_t).
  205.  * @see MB_TV_NR_PLAYBACK_END_REACHED
  206.  * @see mb_tv_playback_side_t 
  207.  */
  208. #define MB_TV_PB_BUFFER_SIDE_ARG(args)          ((args)->arg[1].l)
  210. /** Machblue TV language argument (mb_char_t)
  211.  * @see MB_TV_NR_LANGUAGE_CHANGED
  212.  * @see mb_char_t
  213.  */
  214. #define MB_TV_LANGUAGE_ARG(args)                ((args)->arg[0].vp)
  216. /** Machblue TV pin validation type argument (mb_tv_pin_type_t).
  217.  * @see MB_TV_NR_PIN_VALIDATION_STATUS
  218.  * @see mb_tv_pin_type_t
  219.  */
  220. #define MB_TV_PIN_VALIDATION_TYPE_ARG(args)     ((args)->arg[1].l)
  222. /** Machblue TV asset purchase id argument (mb_char_t).
  223.  * @see MB_TV_NR_ASSET_PURCHASE_STATUS 
  224.  * @see mb_char_t
  225.  */
  226. #define MB_TV_ASSET_PURCHASE_ID_ARG(args)       ((args)->arg[1].vp)
  229. /*----------------------------------------------------------
  230.  | Type definition below this line
  231.  +----------------------------------------------------------*/
  233. /** Machblue TV notification reasons */
  234. typedef enum {
  235.     MB_TV_NR_SVL_LIST_CHANGED = 0,  /**< machblue tv list of service lists changed notify reason. This message is 
  236.                                          generated asynchronously whenever the system's list of service lists 
  237.                                          changes. */
  239.     MB_TV_NR_SERVICE_LISTS_GET,     /**< machblue tv service lists get notify reason. This message is 
  240.                                          generated in response to an mb_tv_service_lists_get() request.
  241.                                          @li MB_TV_STATUS_ARG(args)   = MB_SUCCESS if the request succeeded,
  242.                                                                         MB_FAILURE otherwise.
  243.                                          @li MB_TV_SVL_LIST_ARG(args) = user provided pointer to the list of 
  244.                                                                         service lists requested. */
  246.     MB_TV_NR_SVL_CHANGED,           /**< machblue tv service list changed notify reason. This message is 
  247.                                          generated asynchronously whenever a service list object changes. 
  248.                                          @li MB_TV_SVL_ARG(args) = service list object that changed. */
  250.     MB_TV_NR_SERVICES_GET,          /**< machblue tv services get notify reason. This message is 
  251.                                          generated in response to an mb_tv_services_get() request.
  252.                                          @li MB_TV_STATUS_ARG(args)       = MB_SUCCESS if the request succeeded,
  253.                                                                             MB_FAILURE otherwise.
  254.                                          @li MB_TV_SERVICE_LIST_ARG(args) = user provided pointer to the list of 
  255.                                                                             service objects requested. */
  257.     MB_TV_NR_SERVICE_GET_FROM_URL, /**< machblue tv service get from url notify reason. This message is 
  258.                                          generated in response to an mb_tv_service_get_from_url() request.
  259.                                          @li MB_TV_STATUS_ARG(args)      = MB_SUCCESS if the request succeeded,
  260.                                                                            MB_FAILURE otherwise.
  261.                                          @li MB_TV_SERVICE_PTR_ARG(args) = user provided pointer to service object 
  262.                                                                            requested  */
  263.                                                        
  264.     MB_TV_NR_CURRENT_EVENT_CHANGED,       /**< machblue tv current event changed notify reason. This message is 
  265.                                                generated asynchronously whenever the current event of a service 
  266.                                                object changes. 
  267.                                                @li MB_TV_SERVICE_ARG(args) = service object being notified. */
  269.     MB_TV_NR_SERVICE_CURRENT_EVENT_GET,   /**< machblue tv service current event get notify reason. 
  270.                                                This message is generated in response to an 
  271.                                                mb_tv_service_current_event_get() request.
  272.                                                @li MB_TV_STATUS_ARG(args) = MB_SUCCESS if the request succeeded,
  273.                                                                             MB_FAILURE otherwise.
  274.                                                @li MB_TV_EVENT_ARG(args)  = user provided pointer to current event 
  275.                                                                             objects requested.*/
  277.     MB_TV_NR_SERVICE_FOLLOWING_EVENT_GET, /**< machblue tv service following event get notify reason. 
  278.                                                This message is generated in response to an 
  279.                                                mb_tv_service_foollowing_event_get() request.
  280.                                                @li MB_TV_STATUS_ARG(args) = MB_SUCCESS if the request succeeded,
  281.                                                                             MB_FAILURE otherwise.
  282.                                                @li MB_TV_EVENT_ARG(args)  = user provided pointer to following event 
  283.                                                                             object requested. */
  285.     MB_TV_NR_SERVICE_EVENT_SCHEDULE_GET,  /**< machblue tv service event schedule get notify reason. 
  286.                                                This message is generated in response to an 
  287.                                                mb_tv_service_event_schedule_get() request.
  288.                                                @li MB_TV_STATUS_ARG(args) = MB_SUCCESS if the request succeeded,
  289.                                                                             MB_FAILURE otherwise.
  290.                                                @li MB_TV_EVS_ARG(args)    = user provided pointer to event schedule 
  291.                                                                             object requested.*/
  293.     MB_TV_NR_EVS_CHANGED,                 /**< machblue tv event schedule changed notify reason. 
  294.                                                This message is generated asynchronously whenever an event schedule 
  295.                                                object changes.
  296.               @li MB_TV_SERVICE_ARG(args) = service object being notified.
  297.                                                @li MB_TV_EVS_ARG(args)     = event schedule object that changed. */
  299.     MB_TV_NR_EVS_EVENTS_GET,              /**< machblue tv service event schedule events get notify reason. 
  300.                                                This message is generated in response to an mb_tv_evs_events_get() 
  301.                                                request.
  302.                                                @li MB_TV_STATUS_ARG(args)     = MB_SUCCESS if the request succeeded,
  303.                                                                                 MB_FAILURE otherwise.
  304.                                                @li MB_TV_EVENT_LIST_ARG(args) = user provided pointer to list of event
  305.                                                                                 objects requested.*/
  307.     MB_TV_NR_SVC_LIST_CHANGED,            /**< machblue tv list of service context changed notify reason. This message is 
  308.                                                generated asynchronously whenever the system's list of service contexts 
  309.                                                changes. */
  311.     MB_TV_NR_SERVICE_CONTEXTS_GET,        /**< machblue tv service contexts get notify reason. 
  312.                                                This message is generated in response to an mb_tv_service_contexts_get() 
  313.                                                request.
  314.                                                @li MB_TV_STATUS_ARG(args)   = MB_SUCCESS if the request succeeded,
  315.                                                                               MB_FAILURE otherwise.
  316.                                                @li MB_TV_SVC_LIST_ARG(args) = user provided pointer to list of service
  317.                                                                               contexts objects requested.*/
  319.     MB_TV_NR_STREAM_LIST_CHANGED,         /**< machblue tv list of streams changed notify reason. This message is 
  320.                                                generated asynchronously whenever a stream controller's list of 
  321.                                                streams changes. 
  322.                                                @li MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified */
  324.     MB_TV_NR_STREAMS_INFO_GET,            /**< machblue tv streams info get notify reason. 
  325.                                                This message is generated in response to an mb_tv_stc_streams_info_get() 
  326.                                                request.
  327.                                                @li MB_TV_STATUS_ARG(args)           = MB_SUCCESS if the request succeeded,
  328.                                                                                       MB_FAILURE otherwise.
  329.                                                @li MB_TV_STREAM_INFO_LIST_ARG(args) = user provided pointer to list of 
  330.                                                                                       stream info structures requested.*/
  332.     MB_TV_NR_TRICK_PLAY,                  /**< machblue tv trick play notify reason. 
  333.                                                This message is generated in response to an mb_tv_stc_trick_play() 
  334.                                                request.
  335.                                                @li MB_TV_STATUS_ARG(args)            = MB_SUCCESS if the request succeeded,
  336.                                                                                        MB_FAILURE otherwise.
  337.                                                @li MB_TV_TRICK_PLAY_CMD_ARG(args)    = trick play command requested. 
  338.                                                @li MB_TV_TRICK_PLAY_PARAM_ARG(args)  = trick play command parameters as
  339.                                                                                        modified by the hardware based on what the
  340.                                                                                        hardware supports. */
  342.     MB_TV_NR_RECORDING_LIST_CHANGED,      /**< machblue tv recording list changed notify reason. 
  343.                                                This message is generated asynchronously whenever the system's 
  344.                                                list of recordings changes. */
  346.     MB_TV_NR_RECORDINGS_GET,              /**< machblue tv recordings get notify reason. 
  347.                                                This message is generated in response to an mb_tv_recordings_get() 
  348.                                                request.
  349.                                                @li MB_TV_STATUS_ARG(args)         = MB_SUCCESS if the request succeeded,
  350.                                                                                     MB_FAILURE otherwise.
  351.                                                @li MB_TV_RECORDING_LIST_ARG(args) = user provided pointer to list of 
  352.                                                                                     recordings requested. */
  354.     MB_TV_NR_EVENT_RECORD,                /**< machblue tv event record notify reason. 
  355.                                                This message is generated in response to an mb_tv_event_record() 
  356.                                                request.
  357.                                                @li MB_TV_STATUS_ARG(args)        = MB_SUCCESS if the request succeeded,
  358.                                                                                    MB_FAILURE otherwise.
  359.                                                @li MB_TV_RECORDING_PTR_ARG(args) = user provided recording pointer argument. */
  361.     MB_TV_NR_SERVICE_RECORD,              /**< machblue tv service record notify reason. 
  362.                                                This message is generated in response to an mb_tv_service_record() 
  363.                                                request.
  364.                                                @li MB_TV_STATUS_ARG(args)        = MB_SUCCESS if the request succeeded,
  365.                                                                                    MB_FAILURE otherwise.
  366.                                                @li MB_TV_RECORDING_PTR_ARG(args) = user provided recording pointer argument. */
  368.     MB_TV_NR_RECORDING_CHANGED,           /**< machblue tv recording changed notify reason. 
  369.                                                This message is generated asynchronously whenever a recording's state
  370.                                                changes. 
  371.                                                @li MB_TV_RECORDING_ARG(args) = recording object being notified. */
  373.     MB_TV_NR_SERVICE_SELECTED,   /**< machblue tv service selected nofify reason. This message is generated 
  374.                                       in response to an mb_tv_sc_service_select() request.
  375.                                       @li MB_TV_SERVICE_CONTEXT_ARG(args)  = service context being notified
  376.                                       @li MB_TV_SELECTED_SERVICE_ARG(args) = handle of the service selected */
  378.     MB_TV_NR_SERVICE_ERROR,      /**< machblue tv service error nofify reason. This message is generated in 
  379.                                       response to mb_tv_sc_service_select() request.
  380.                                       @li MB_TV_SERVICE_CONTEXT_ARG(args) = service context being notified
  381.                                       @li MB_TV_SELECT_SERVICE_ARG(args)  = handle of the service selected
  382.                                       @li MB_TV_SERVICE_ERROR_ARG(args)   = manufacturer specific service error code */
  384.     MB_TV_NR_STREAM_ENABLED,     /**< machblue tv stream enabled nofify reason. This message is generated in
  385.                                       response to an mb_tv_sc_stream_enable() request.
  386.                                       @li MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified
  387.                                       @li MB_TV_STREAM_TYPE_ARG(args)       = type of stream being notified
  388.                                                                              (MB_TV_STREAM_TYPE_AUDIO, etc.) */
  390.     MB_TV_NR_STREAM_DISABLED,    /**< machblue tv stream disabled nofify reason. This message is generated in
  391.                                       response to an mb_tv_sc_stream_disable() request.
  392.                                       @li MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified
  393.                                       @li MB_TV_STREAM_TYPE_ARG(args)       = type of stream being notified
  394.                                                                               (MB_TV_STREAM_TYPE_AUDIO, etc.) */
  396.     MB_TV_NR_STREAM_ERROR,       /**< machblue tv stream disabled nofify reason. This message is generated in
  397.                                       response to an mb_tv_sc_stream_enable() or mb_tv_sc_stream_disable request().
  398.                                       @li MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified
  399.                                       @li MB_TV_STREAM_TYPE_ARG(args)       = type of stream being notified
  400.                                                                               (MB_TV_STREAM_TYPE_AUDIO, etc.)
  401.                                       @li MB_TV_STREAM_ERROR_ARG(args)      = manufacturer specific stream error code. */
  403.     MB_TV_NR_SIGNAL_LOST,        /**< machblue tv signal lost nofify reason. This message is generated asynchronously
  404.                                       whenever a source has lost its signal.
  405.                                       @li MB_TV_SERVICE_CONTEXT_ARG(args) = service context being notified if any, 0
  406.                                                                             otherwise.
  407.                                       @li MB_TV_SOURCE_ID_ARG(args)       = id of the source that lost signal */
  409.     MB_TV_NR_SIGNAL_RECOVERED,   /**< machblue tv signal recovered nofify reason. This message is generated in 
  410.                                       generated asynchronously whenever a source has recovered its signal.
  411.                                       @li MB_TV_SERVICE_CONTEXT_ARG(args) = service context being notified if any, 0
  412.                                                                             otherwise.
  413.                                       @li MB_TV_SOURCE_ID_ARG(args)       = id of the source that lost signal */
  415.     MB_TV_NR_RECORDER_CONFLICT,  /**< machblue tv recording conflict nofify reason. This message is generated 
  416.                                       whenever a recoder conflict is detected.
  417.                                       @li MB_TV_CONFLICT_ARG(args)                = recording conflict unique identifier
  418.                                       @li MB_TV_CONFLICT_RECORDING_LIST_ARG(args) = MB_TV_INVALID_RECORDING terminated 
  419.                                                                                     list of conflicting recordings */
  421.     MB_TV_NR_CA_ERROR,           /**< machblue tv conditional access error nofify reason. This message is generated
  422.                                       by the manufacturer's condtional access system in case of error (stream 
  423.                                       playback error)
  424.                                       @li MB_TV_SERVICE_CONTEXT_ARG(args) = service context being notified
  425.                                       @li MB_TV_CA_ERROR_ARG(args)        = conditional access error code */
  427.     MB_TV_NR_VOD_SESSION_CONNECTED,    /**< machblue tv vod session connected nofify reason. This message is 
  428.                                             generated in response to an mb_tv_vod_session_setup() request.
  429.                                             @li MB_TV_VOD_SESSION_POINTER_ARG(args) = user provided pointer to handle 
  430.                                                                                       of the vod session connected */
  432.     MB_TV_NR_VOD_SESSION_DISCONNECTED, /**< machblue tv vod session disconnected nofify reason. This message is 
  433.                                             generated in response to an mb_tv_vod_session_delete() request.
  434.                                             @li MB_TV_VOD_SESSION_ARG(args) = handle of the vod session disconnected */
  436.     MB_TV_NR_VOD_SESSION_TIMEOUT,      /**< machblue tv vod session timeout nofify reason. This message is 
  437.                                             generated when a vod session has timeout due to user inactivity.
  438.                                             @li MB_TV_VOD_SESSION_ARG(args) = handle of the vod session that has timed 
  439.                                                                               out */
  441.     MB_TV_NR_VOD_SESSION_ERROR,        /**< machblue tv vod session setup nofify reason. This message is generated 
  442.                                             in response to an mb_tv_vod_session_setup() request.
  443.                                             @li MB_TV_VOD_SESSION_ARG(args)       = user provided pointer to handle of 
  444.                                                                                     the vod session in error
  445.                                             @li MB_TV_VOD_SESSION_ERROR_ARG(args) = manufacturer specific vod session 
  446.                                                                                     error code. */
  448.     MB_TV_NR_PLAYBACK_POSITION_NOTIFY, /**< machblue tv playback position nofify reason. This message is sent the first 
  449.                                             time the current video playback position is greater or equal to the  position
  450.                                             value set with mb_tv_stc_playback_position_notify().
  451.                                             @li MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified.
  452.                                             @li MB_TV_PB_POSITION_VALUE_ARG(args) = pointer to mb_system_time_t representing
  453.                                                                                     the playback position value requested in 
  454.                                                                                     nano-seconds. */
  456.     MB_TV_NR_PLAYBACK_END_REACHED,     /**< machblue tv playback end nofify reason. This message is sent asynchronously
  457.                                             when the current video playback head reaches the end (for forward playbacks,
  458.                                             fast forwards, etc.) or the beginning (for backward playbacks, rewinds, etc.)
  459.                                             of the playback buffer.
  460.                                             MB_TV_STREAM_CONTROLLER_ARG(args) = stream controller being notified.
  461.                                             MB_TV_PB_BUFFER_SIDE_ARG(args)    = MB_TV_PB_BUFFER_BEGINNING if the beginning 
  462.                                                                                 of the buffer was reached, otherwise
  463.                                                                                 MB_TV_PB_BUFFER_END   */
  466.     MB_TV_NR_LANGUAGE_CHANGED,         /**< machblue tv language change notify reason. This event is sent whenever 
  467.                                             the default ui language is changed.
  468.                                             @li MB_TV_LANGUAGE_ARG(args) = current language string */
  470.     MB_TV_NR_OUT_OF_STORAGE,           /**< machblue tv out of recorder storage notify reason. This event is sent 
  471.                                             whenever the recorder runs out of storage. */
  473.     MB_TV_NR_PIN_VALIDATION_STATUS,    /**< machblue tv pin validate notify reason. This event is sent 
  474.                                             whenever a pin validation request has been completed. This event is
  475.                                             generated in response to an mb_tv_pin_validate() request.
  476.                                             @li MB_TV_STATUS_ARG(args)              = MB_SUCCESS if pin validation 
  477.                                                                                       succeeded, MB_FAILURE 
  478.                                                                                       otherwise
  479.                                             @li MB_TV_PIN_VALIDATION_TYPE_ARG(args) = type of pin validation 
  480.                                                                                       completed */
  482.     MB_TV_NR_ASSET_PURCHASE_STATUS,    /**< machblue tv asset purchase request notify reason. This event is sent 
  483.                                             whenever an asset purchase request has been completed. This event is
  484.                                             generated in response to an mb_tv_asset_purchase() request.
  485.                                             @li MB_TV_STATUS_ARG(args)                = MB_SUCCESS if the asset purchase 
  486.                                                                                         succeeded, MB_FAILURE 
  487.                                                                                         otherwise 
  488.                                             @li MB_TV_ASSET_PURCHASE_ID_ARG(args)     = id of the asset being purchased. */
  490.     MB_TV_NR_LAST
  491. } mb_tv_notif_reason_t;
  494. /** Machblue client notification function */
  495. typedef mb_error_t (mb_tv_notify_f)( mb_tv_notif_reason_t reason, mb_args_t *args, void *client_data );
  498. /** Machblue TV service list info type */
  499. typedef struct {
  500.     int                  id;                                 /**< service list id if any */
  501.     mb_char_t            name[MB_TV_SVL_NAME_LENGTH];        /**< service list name */
  502.     mb_char_t            logo_url[MB_TV_URL_LENGTH];         /**< service list logo url */
  503.     mb_char_t            extra_info[MB_TV_SVL_EXTRA_LENGTH]; /**< system dependent extra service list info */
  504. } mb_tv_svl_info_t;
  507. /** Machblue TV service type enum */
  508. typedef enum {
  509.     MB_TV_DIGITAL_SERVICE = 0,  /**< digital service type */
  510.     MB_TV_ANALOG_SERVICE,       /**< analog service type */
  511.     MB_TV_DATA_SERVICE,         /**< data service type */
  512.     MB_TV_ETV_SERVICE,          /**< enhanced tv service type */
  513.     MB_TV_LAST_SERVICE_TYPE
  514. } mb_tv_service_type_t;
  517. /** Machblue TV service source enum */
  518. typedef enum {
  519.     MB_TV_CABLE_SOURCE = 0,           /**< cable broadcast source */
  520.     MB_TV_SATELLITE_SOURCE,           /**< satellite broadcast source */
  521.     MB_TV_IPTV_SOURCE,                /**< iptv broadcast source */
  522.     MB_TV_TERRESTRIAL_SOURCE,         /**< terrestrial broadcast source */
  523.     MB_TV_RECORDER_SOURCE,            /**< recorder source */
  524.     MB_TV_VOD_SOURCE,                 /**< vod source */
  525.     MB_TV_LAST_SOURCE_TYPE
  526. } mb_tv_source_type_t;
  529. /** Machblue TV service source info */
  530. typedef struct {
  531.     int                 id;    /**< unique source id */
  532.     mb_tv_source_type_t type;  /**< source type */
  533. } mb_tv_source_info_t;
  536. /** Machblue TV service info type */
  537. typedef struct {
  538.     int                  id;                                     /**< service channel unique id if any */
  539.     int                  display_id;                             /**< service channel display id (i.e. channel 
  540.                                                                       number) if any */    
  541.     mb_char_t            name[MB_TV_SERVICE_NAME_LENGTH];        /**< service name */
  542.     mb_tv_service_type_t type;                                   /**< service type */
  543.     mb_tv_source_info_t  source_info;                            /**< service source info */
  544.     mb_char_t            logo_url[MB_TV_URL_LENGTH];             /**< service logo url */
  545.     mb_char_t            extra_info[MB_TV_SERVICE_EXTRA_LENGTH]; /**< system dependent extra service info */
  546. } mb_tv_service_info_t;
  549. /** Machblue TV authorization flags enum */
  550. typedef enum {
  551.     MB_TV_AF_AUTHORIZED       = 0x0,  /**< service/event/asset is authorized */
  552.     MB_TV_AF_PARENTAL_PIN_REQ = 0x1,  /**< parental control pin is required to access service/event/asset */
  553.     MB_TV_AF_SUBSCRIPTION_REQ = 0x2,  /**< subscription is required to access service/event/asset */
  554.     MB_TV_AF_PURCHASE_REQ     = 0x4,  /**< purchase is required to access service/event/asset */
  555.     MB_TV_AF_BLACKED_OUT      = 0x8,  /**< service/event/asset is currently blacked out */
  556.     MB_TV_AF_LAST
  557. } mb_tv_authorization_flag_t;
  560. /** Machblue TV service state enum type */
  561. typedef enum {
  562.     MB_TV_SERVICE_ERROR = 0,     /**< service error state */
  563.     MB_TV_SERVICE_CONNECTED,     /**< service connected state */
  564.     MB_TV_SERVICE_DISCONNECTED,  /**< service disconnected state */ 
  565.     MB_TV_LAST_SERVICE_STATE
  566. } mb_tv_service_state_t;
  569. /** Machblue TV event description type */
  570. typedef struct {
  571.  int           id;                                          /**< unique event id */
  572.     unsigned long duration;                                    /**< event duration in seconds */
  573.     mb_char_t     name[MB_TV_EVENT_NAME_LENGTH];               /**< event name */
  574.     mb_char_t     short_desc[MB_TV_EVENT_DESCRIPTION_LENGTH];  /**< event short description */
  575.     mb_char_t     rating[MB_TV_RATING_LENGTH];                 /**< event ratings */
  576.     mb_char_t     genre[MB_TV_GENRE_LENGTH];                   /**< event genre */
  577.     mb_char_t     long_desc_url[MB_TV_URL_LENGTH];             /**< event long description url */
  578.     mb_char_t     art_url[MB_TV_URL_LENGTH];                   /**< event art work url */
  579.     mb_char_t     extra_info[MB_TV_EVENT_EXTRA_LENGTH];        /**< system dependent extra event info */
  580. } mb_tv_event_info_t;
  583. /** Machblue TV event attributes type */
  584. typedef struct {
  585.     mb_tv_event_info_t event_info;      /**< event information structure */
  586.     mb_time_t          start_time;      /**< event start time in seconds since 01/01/1970 UTC.
  587.                                              For VOD and Recorded events this should be relative to the 
  588.                                              begining of the Recordings or VOD sessions */
  589.     int                cost;            /**< event cost */
  590.     mb_time_t          expiration_date; /**< event expiration date in seconds since 01/01/1970 UTC */
  591. } mb_tv_event_attributes_t;
  594. /** Machblue TV service context info type */
  595. typedef struct {
  596.     int                  id;                                     /**< service context id if any */
  597.     mb_char_t            name[MB_TV_SVC_NAME_LENGTH];            /**< service context name */
  598.     mb_char_t            extra_info[MB_TV_SVC_EXTRA_LENGTH];     /**< system dependent extra service context info */
  599. } mb_tv_service_context_info_t;
  602. /** Machblue TV viewport type */
  603. typedef struct {
  604.     mb_rect_t bounds;    /**< viewport coordinates */
  605.     int       z_order;   /**< viewport z-order */
  606. } mb_tv_viewport_t;
  609. /** Machblue TV stream state enum type */
  610. typedef enum {
  611.     MB_TV_STREAM_ERROR = 0,  /**< stream error state */
  612.     MB_TV_STREAM_ENABLED,    /**< stream enabled state */
  613.     MB_TV_STREAM_DISABLED,   /**< stream disabled state */ 
  614.     MB_TV_LAST_STREAM_STATE
  615. } mb_tv_stream_state_t;
  618. /** Machblue TV stream type */
  619. typedef enum {
  620.     MB_TV_STREAM_TYPE_AUDIO = 0,  /**< audio stream type */
  621.     MB_TV_STREAM_TYPE_VIDEO,      /**< video stream type */
  622.     MB_TV_STREAM_TYPE_DATA,       /**< data stream type */
  623.     MB_TV_STREAM_TYPE_SUBTITLE,   /**< subtitle stream type */
  624.     MB_TV_LAST_STREAM_TYPE
  625. } mb_tv_stream_type_t;
  628. /** Machblue TV stream info type */
  629. typedef struct {
  630.     mb_tv_stream_type_t type;                                    /**< stream type */
  631.     mb_char_t           tag[MB_TV_STREAM_TAG_LENGTH];            /**< stream tag identifier */
  632.     unsigned long       bitrate;                                 /**< stream bitrate in bps if known */
  633.     mb_char_t           format[MB_TV_STREAM_FORMAT_LENGTH];      /**< stream format if known */
  634.     mb_char_t           language[MB_TV_LANGUAGE_LENGTH];         /**< stream language if applicable */
  635.     mb_char_t           extra_info[MB_TV_STREAM_EXTRA_LENGTH];   /**< pointer to system dependent extra info */
  636. } mb_tv_stream_info_t;
  639. /** Machblue TV trick play command */
  640. typedef enum {
  641.     MB_TV_PAUSE_CMD = 0,            /**< pauses an av stream at the current playing location.
  642.                                          param = timeout in ms of the pause command */
  644.     MB_TV_RESUME_CMD,               /**< resumes a previously paused av stream. */
  646.     MB_TV_RATE_CONTROL_CMD,         /**< plays the video stream at the rate specified in hundredths of normal 
  647.                                          speed. This command is used to achieve fast forward, rewind, slow motion 
  648.                                          and reverse slow motion effect. 
  649.                                          @li param = rate control speed in hundredths of normal speed. 
  650.                                                      @li A negative value indicates a reverse motion playback.
  651.                                                      @li A value of 100 indicates a return to normal play speed. */
  653.     MB_TV_FRAME_JUMP_CMD,           /**< jumps a specified number of frames forward or backward in an av 
  654.                                          stream.
  655.                                          @li param = number of frames to jump. A negative number indicates a jump 
  656.                                                      backward in the stream */
  658.     MB_TV_JOIN_LIVE_CMD,            /**< jumps to an av stream live position if any */
  660.     MB_TV_RESTART_CMD,              /**< jumps to the begining of the current playback buffer if any */
  662.     MB_TV_LAST_TRICK_CMD
  663. } mb_tv_trick_play_cmd_t;
  666. /** Machblue TV playback buffer side enum */
  667. typedef enum {
  668.     MB_TV_PB_BUFFER_BEGINNING = 0,   /**< indicates the beginning of the bufffer */
  669.     MB_TV_PB_BUFFER_END,             /**< indicates the end of the bufffer */
  670.     MB_TV_PB_BUFFER_LAST
  671. } mb_tv_playback_buffer_side_t;
  674. /** Machblue TV periodicity type */
  675. typedef enum {
  676.     MB_TV_PERIODICITY_ONCE = 1,    /**< the recording should be done only once */
  677.     MB_TV_PERIODICITY_DAILY,       /**< the recording should be repeated daily at this time slot*/
  678.     MB_TV_PERIODICITY_WEEKLY,      /**< the recording should be repeated weekly this day at this time slot*/
  679.     MB_TV_PERIODICITY_ANYTIME,     /**< the recording should be repeated anytime the event is on */
  680.     MB_TV_PERIODICITY_LAST 
  681. } mb_tv_periodicity_t;
  684. /** Machblue TV recording attributes type */
  685. typedef struct {
  686.     int                 id;                                 /**< unique recording id */
  687.     mb_size_t           size;                               /**< recording size in KB */
  688.     mb_time_t           start_time;                         /**< recording start time in seconds since
  689.                                                                  01/01/1970 UTC */
  690.     mb_time_t           end_time;                           /**< recording end time in seconds since
  691.                                                                  01/01/1970 UTC */
  692.     mb_time_t           delete_time;                        /**< recording automatic delete time in seconds
  693.                                                                  since 01/01/1970 UTC */
  694.     mb_tv_periodicity_t periodicity;                        /**< recording periodicity, i.e. if the recording
  695.                                                                  is part of a series, the periodicity of the
  696.                                                                  series. */
  697.     mb_char_t           extra_info[MB_TV_RA_EXTRA_LENGTH];  /**< system dependent extra recording info */
  698. } mb_tv_recording_attributes_t;
  701. /** Machblue TV recording state enum */
  702. typedef enum {
  703.     MB_TV_RS_RECORDING = 0,   /**< recording state */
  704.     MB_TV_RS_PLAYING,         /**< playing back state */
  705.     MB_TV_RS_STORED,          /**< stored state */
  706.     MB_TV_RS_DELETED,         /**< deleted state */
  707.     MB_TV_RS_SCHEDULED,       /**< scheduled state -- i.e. programmed but not yet recorded */ 
  708.     MB_TV_RS_LAST
  709. } mb_tv_recording_state_t;
  712. /** Machblue TV vod session state enum type */
  713. typedef enum {
  714.     MB_TV_VOD_ERROR_STATE = 0,        /**< vod session error state */
  715.     MB_TV_VOD_DISCONNECTED_STATE,     /**< vod session disconnected state */
  716.     MB_TV_VOD_CONNECTED_STATE,        /**< vod session connected state  */ 
  717.     MB_TV_VOD_LAST_STATE
  718. } mb_tv_vod_session_state_t;
  721. /** Machblue TV pin type */
  722. typedef enum {
  723.     MB_TV_PURCHASE_PIN = 0,      /**< purchase pin type */
  724.     MB_TV_PARENTAL_CONTROL_PIN,  /**< parental control pin type */
  725.     MB_TV_LAST_PIN_TYPE
  726. } mb_tv_pin_type_t;
  729. /** Machblue System Capabilities type */
  730. typedef enum {
  731.     MB_TV_SCALED_VIDEO_CAP  = 0x1,  /**< device is scaled video capable */
  732.     MB_TV_HD_CAP            = 0x2,  /**< device is capable of displaying High Definition content */
  733.     MB_TV_PVR_CAP           = 0x4,  /**< device is capable of recording event */
  734.     MB_TV_PIP_CAP           = 0x8,  /**< device is picture in picture capable */
  735.     MB_TV_LAST_CAP
  736. } mb_tv_device_caps_t;
  739. /** Machblue TV device info type */
  740. typedef struct {
  741.     mb_char_t            manufacturer[MB_TV_DEVICE_MANUFACTURER_LENGTH];  /**< manufacturer name */
  742.     mb_char_t            model[MB_TV_DEVICE_MODEL_LENGTH];                /**< model name */
  743.     mb_char_t            os_name[MB_TV_DEVICE_OS_LENGTH];                 /**< os name */
  744.     mb_char_t            os_version[MB_TV_DEVICE_OS_VERSION_LENGTH];      /**< os version */
  745.     mb_char_t            resident_app[MB_TV_DEVICE_RES_APP_LENGTH];       /**< resident application name */
  746.     mb_char_t            unique_id[MB_TV_DEVICE_UNIQUE_ID_LENGTH];        /**< unique device id */
  747.     mb_char_t            mac_address[MB_TV_DEVICE_MAC_ADDRESS_LENGTH];    /**< mac address (empty if not available) */
  748.     mb_char_t            ip_address[MB_TV_DEVICE_IP_ADDRESS_LENGTH];      /**< ip address (0.0.0.0 if not available) */
  749.     unsigned long        capabilities;                                    /**< device capabilities bitfield defined
  750.                                                                                in mb_tv_device_caps_t.
  751.                                                                                @see mb_tv_device_caps_t */
  752.     mb_char_t            extra_info[MB_TV_DEVICE_EXTRA_LENGTH];           /**< system dependent extra device info */
  753. } mb_tv_device_info_t;
  756. /** Machblue TV device state type */
  757. typedef enum {
  758.     MB_TV_BOOTING_STATE = 0,    /**< booting state */
  759.     MB_TV_POWER_OFF_STATE,      /**< power off state */
  760.     MB_TV_POWER_ON_STATE,       /**< power on state */
  761.     MB_TV_LAST_STATE            /**< */
  762. } mb_tv_device_state_t;
  766. /*----------------------------------------------------------
  767.  | Functions definition below this line
  768.  +----------------------------------------------------------*/
  772. #ifdef __cplusplus
  774. }      /* extern "C" */  
  776. #endif /* __cplusplus */
  780. #endif /* _MACHBLUE_TV_DEFINES_H_ */