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

   1 /*****************************************************************************
   2  * vlc_access.h
   3  *****************************************************************************
   4  * Copyright (C) 1999-2004 VideoLAN
   5  * $Id: ninput.h 7930 2004-06-07 18:23:15Z fenrir $
   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., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  22  *****************************************************************************/
  23
  24 #ifndef _VLC_ACCESS_H
  25 #define _VLC_ACCESS_H 1
  26
  27 /**
  28  * \defgroup access Access
  29  * @{
  30  */
  31
  32 enum access_query_e
  33 {
  34     /* capabilities */
  35     ACCESS_CAN_SEEK,        /* arg1= vlc_bool_t*    cannot fail */
  36     ACCESS_CAN_FASTSEEK,    /* arg1= vlc_bool_t*    cannot fail */
  37     ACCESS_CAN_PAUSE,       /* arg1= vlc_bool_t*    cannot fail */
  38     ACCESS_CAN_CONTROL_PACE,/* arg1= vlc_bool_t*    cannot fail */
  39
  40     /* */
  41     ACCESS_GET_MTU,         /* arg1= int*           cannot fail(0 if no sense)*/
  42     ACCESS_GET_PTS_DELAY,   /* arg1= int64_t*       cannot fail */
  43     /* */
  44     ACCESS_GET_TITLE_INFO,      /* arg1=input_title_t*** arg2=int* can fail */
  45
  46     /* */
  47     ACCESS_SET_PAUSE_STATE, /* arg1= vlc_bool_t     can fail */
  48
  49     /* */
  50     ACCESS_SET_TITLE,       /* arg1= int            can fail */
  51     ACCESS_SET_SEEKPOINT,   /* arg1= int            can fail */
  52
  53     /* Special mode for access/demux communication
  54      * XXX: avoid to use it unless you can't */
  55     ACCESS_SET_PRIVATE_ID_STATE,    /* arg1= vlc_bool_t b_selected, int i_private_data can fail */
  56 };
  57
  58 struct access_t
  59 {
  60     VLC_COMMON_MEMBERS
  61
  62     /* Module properties */
  63     module_t    *p_module;
  64
  65     /* Access name (empty if non forced) */
  66     char        *psz_access;
  67     /* Access path/url/filename/.... */
  68     char        *psz_path;
  69
  70     /* Access can fill this entry to force a demuxer
  71      * XXX: fill it once you know for sure you will succed
  72      * (if you fail, this value won't be reseted */
  73     char        *psz_demux;
  74
  75     /* pf_read/pf_block is used to read data.
  76      * XXX A access should set one and only one of them */
  77     int         (*pf_read) ( access_t *, uint8_t *, int );  /* Return -1 if no data yet, 0 if no more data, else real data read */
  78     block_t    *(*pf_block)( access_t * );                  /* return a block of data in his 'natural' size, NULL if not yet data or eof */
  79
  80     /* Called for each seek.
  81      * XXX can be null */
  82     int         (*pf_seek) ( access_t *, int64_t );         /* can be null if can't seek */
  83
  84     /* Used to retreive and configure the access
  85      * XXX mandatory. look at access_query_e to know what query you *have to* support */
  86     int         (*pf_control)( access_t *, int i_query, va_list args);
  87
  88     /* Access has to maintain them uptodate */
  89     struct
  90     {
  91         unsigned int i_update;  /* Access sets them on change,
  92                                    Input removes them once take into account*/
  93
  94         int64_t      i_size;    /* Write only for access, read only for input */
  95         int64_t      i_pos;     /* idem */
  96         vlc_bool_t   b_eof;     /* idem */
  97
  98         int          i_title;    /* idem, start from 0 (could be menu) */
  99         int          i_seekpoint;/* idem, start from 0 */
 100     } info;
 101     access_sys_t *p_sys;
 102 };
 103
 104 #define access2_New( a, b, c, d ) __access2_New(VLC_OBJECT(a), b, c, d )
 105 VLC_EXPORT( access_t *, __access2_New,  ( vlc_object_t *p_obj, char *psz_access, char *psz_demux, char *psz_path ) );
 106 VLC_EXPORT( void,      access2_Delete, ( access_t * ) );
 107
 108 static inline int access2_vaControl( access_t *p_access, int i_query, va_list args )
 109 {
 110     return p_access->pf_control( p_access, i_query, args );
 111 }
 112 static inline int access2_Control( access_t *p_access, int i_query, ... )
 113 {
 114     va_list args;
 115     int     i_result;
 116
 117     va_start( args, i_query );
 118     i_result = access2_vaControl( p_access, i_query, args );
 119     va_end( args );
 120     return i_result;
 121 }
 122
 123 #endif