]> git.sesse.net Git - vlc/blob - include/vlc_vod.h
Add a bunch of \file doxygen comments
[vlc] / include / vlc_vod.h
1 /*****************************************************************************
2  * vlc_vod.h: interface for VoD server modules
3  *****************************************************************************
4  * Copyright (C) 2000, 2001 the VideoLAN team
5  * $Id$
6  *
7  * Author: Gildas Bazin <gbazin@videolan.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 #ifndef VLC_VOD_H
25 #define VLC_VOD_H 1
26
27 /**
28  * \file
29  * This file defines an interface for VOD server modules in vlc
30  */
31
32 /**
33  * \defgroup server Video On Demand (VOD)
34  * Video On Demand (VOD) functionality is provided from VLM.
35  * @{
36  */
37
38 struct vod_t
39 {
40     VLC_COMMON_MEMBERS
41
42     /* Module properties */
43     module_t  *p_module;
44     vod_sys_t *p_sys;
45
46     vod_media_t * (*pf_media_new)   ( vod_t *, const char *, input_item_t * );
47     void          (*pf_media_del)   ( vod_t *, vod_media_t * );
48     int           (*pf_media_add_es)( vod_t *, vod_media_t *, es_format_t * );
49     void          (*pf_media_del_es)( vod_t *, vod_media_t *, es_format_t * );
50
51     /* Owner properties */
52     int (*pf_media_control) ( void *, vod_media_t *, const char *, int, va_list );
53     void *p_data;
54 };
55
56 static inline int vod_MediaControl( vod_t *p_vod, vod_media_t *p_media,
57                                     const char *psz_id, int i_query, ... )
58 {
59     va_list args;
60     int i_result;
61
62     if( !p_vod->pf_media_control ) return VLC_EGENERIC;
63
64     va_start( args, i_query );
65     i_result = p_vod->pf_media_control( p_vod->p_data, p_media, psz_id,
66                                         i_query, args );
67     va_end( args );
68     return i_result;
69 }
70
71 enum vod_query_e
72 {
73     VOD_MEDIA_PLAY,         /* arg1= char *         res=    */
74     VOD_MEDIA_PAUSE,        /* arg1=                res=    */
75     VOD_MEDIA_STOP,         /* arg1=                res=can fail    */
76     VOD_MEDIA_SEEK,         /* arg1= double         res=    */
77     VOD_MEDIA_REWIND,       /* arg1= double         res=    */
78     VOD_MEDIA_FORWARD,      /* arg1= double         res=    */
79 };
80
81 /**}*/
82
83 #endif