vlc_access.h
上传用户:riyaled888
上传日期:2009-03-27
资源大小:7338k
文件大小:5k
源码类别:

多媒体

开发平台:

MultiPlatform

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