git.sesse.net Git - vlc/blob - include/vlc_access.h

   1 /*****************************************************************************
   2  * vlc_access.h: Access descriptor, queries and methods
   3  *****************************************************************************
   4  * Copyright (C) 1999-2006 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
   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_ACCESS_H
  25 #define _VLC_ACCESS_H 1
  26
  27 #include <vlc_block.h>
  28
  29 /**
  30  * \defgroup access Access
  31  * @{
  32  */
  33
  34 enum access_query_e
  35 {
  36     /* capabilities */
  37     ACCESS_CAN_SEEK,        /* arg1= bool*    cannot fail */
  38     ACCESS_CAN_FASTSEEK,    /* arg1= bool*    cannot fail */
  39     ACCESS_CAN_PAUSE,       /* arg1= bool*    cannot fail */
  40     ACCESS_CAN_CONTROL_PACE,/* arg1= bool*    cannot fail */
  41
  42     /* */
  43     ACCESS_GET_MTU,         /* arg1= int*           cannot fail(0 if no sense)*/
  44     ACCESS_GET_PTS_DELAY,   /* arg1= int64_t*       cannot fail */
  45     /* */
  46     ACCESS_GET_TITLE_INFO,  /* arg1=input_title_t*** arg2=int* can fail */
  47     /* Meta data */
  48     ACCESS_GET_META,        /* arg1= vlc_meta_t **  res=can fail    */
  49
  50     /* */
  51     ACCESS_SET_PAUSE_STATE, /* arg1= bool     can fail */
  52
  53     /* */
  54     ACCESS_SET_TITLE,       /* arg1= int            can fail */
  55     ACCESS_SET_SEEKPOINT,   /* arg1= int            can fail */
  56
  57     /* Special mode for access/demux communication
  58      * XXX: avoid to use it unless you can't */
  59     ACCESS_SET_PRIVATE_ID_STATE,    /* arg1= int i_private_data, bool b_selected can fail */
  60     ACCESS_SET_PRIVATE_ID_CA,    /* arg1= int i_program_number, uint16_t i_vpid, uint16_t i_apid1, uint16_t i_apid2, uint16_t i_apid3, uint8_t i_length, uint8_t *p_data */
  61     ACCESS_GET_PRIVATE_ID_STATE,    /* arg1=int i_private_data arg2=bool *  res=can fail */
  62
  63     ACCESS_GET_CONTENT_TYPE, /* arg1=char **ppsz_content_type */
  64 };
  65
  66 struct access_t
  67 {
  68     VLC_COMMON_MEMBERS
  69
  70     /* Module properties */
  71     module_t    *p_module;
  72
  73     /* Access name (empty if non forced) */
  74     char        *psz_access;
  75     /* Access path/url/filename/.... */
  76     char        *psz_path;
  77     /* Access source for access_filter (NULL for regular access) */
  78     access_t    *p_source;
  79
  80     /* Access can fill this entry to force a demuxer
  81      * XXX: fill it once you know for sure you will succeed
  82      * (if you fail, this value won't be reseted */
  83     char        *psz_demux;
  84
  85     /* pf_read/pf_block is used to read data.
  86      * XXX A access should set one and only one of them */
  87     ssize_t     (*pf_read) ( access_t *, uint8_t *, size_t );  /* Return -1 if no data yet, 0 if no more data, else real data read */
  88     block_t    *(*pf_block)( access_t * );                  /* return a block of data in his 'natural' size, NULL if not yet data or eof */
  89
  90     /* Called for each seek.
  91      * XXX can be null */
  92     int         (*pf_seek) ( access_t *, int64_t );         /* can be null if can't seek */
  93
  94     /* Used to retreive and configure the access
  95      * XXX mandatory. look at access_query_e to know what query you *have to* support */
  96     int         (*pf_control)( access_t *, int i_query, va_list args);
  97
  98     /* Access has to maintain them uptodate */
  99     struct
 100     {
 101         unsigned int i_update;  /* Access sets them on change,
 102                                    Input removes them once take into account*/
 103
 104         int64_t      i_size;    /* Write only for access, read only for input */
 105         int64_t      i_pos;     /* idem */
 106         bool   b_eof;     /* idem */
 107
 108         int          i_title;    /* idem, start from 0 (could be menu) */
 109         int          i_seekpoint;/* idem, start from 0 */
 110
 111         bool   b_prebuffered; /* Read only for input */
 112     } info;
 113     access_sys_t *p_sys;
 114 };
 115
 116 static inline int access_vaControl( access_t *p_access, int i_query, va_list args )
 117 {
 118     if( !p_access ) return VLC_EGENERIC;
 119     return p_access->pf_control( p_access, i_query, args );
 120 }
 121
 122 static inline int access_Control( access_t *p_access, int i_query, ... )
 123 {
 124     va_list args;
 125     int     i_result;
 126
 127     va_start( args, i_query );
 128     i_result = access_vaControl( p_access, i_query, args );
 129     va_end( args );
 130     return i_result;
 131 }
 132
 133 static inline char *access_GetContentType( access_t *p_access )
 134 {
 135     char *res;
 136     if( access_Control( p_access, ACCESS_GET_CONTENT_TYPE, &res ) )
 137         return NULL;
 138     return res;
 139 }
 140
 141 static inline void access_InitFields( access_t *p_a )
 142 {
 143     p_a->info.i_update = 0;
 144     p_a->info.i_size = 0;
 145     p_a->info.i_pos = 0;
 146     p_a->info.b_eof = false;
 147     p_a->info.i_title = 0;
 148     p_a->info.i_seekpoint = 0;
 149 }
 150
 151 #define ACCESS_SET_CALLBACKS( read, block, control, seek ) \
 152     p_access->pf_read = read;  \
 153     p_access->pf_block = block; \
 154     p_access->pf_control = control; \
 155     p_access->pf_seek = seek; \
 156
 157 #define STANDARD_READ_ACCESS_INIT \
 158     access_InitFields( p_access ); \
 159     ACCESS_SET_CALLBACKS( Read, NULL, Control, Seek ); \
 160     MALLOC_ERR( p_access->p_sys, access_sys_t ); \
 161     p_sys = p_access->p_sys; memset( p_sys, 0, sizeof( access_sys_t ) );
 162
 163 #define STANDARD_BLOCK_ACCESS_INIT \
 164     access_InitFields( p_access ); \
 165     ACCESS_SET_CALLBACKS( NULL, Block, Control, Seek ); \
 166     MALLOC_ERR( p_access->p_sys, access_sys_t ); \
 167     p_sys = p_access->p_sys; memset( p_sys, 0, sizeof( access_sys_t ) );
 168
 169 #endif