vlc_access.h 6.41 KB
Newer Older
1
/*****************************************************************************
2
 * vlc_access.h: Access descriptor, queries and methods
3
 *****************************************************************************
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
4
 * Copyright (C) 1999-2006 the VideoLAN team
5
 * $Id$
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
 *
 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
Antoine Cellerier's avatar
Antoine Cellerier committed
21
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 23
 *****************************************************************************/

24 25
#ifndef VLC_ACCESS_H
#define VLC_ACCESS_H 1
26

27 28 29 30 31
/**
 * \file
 * This file defines functions and definitions for access object
 */

32 33
#include <vlc_block.h>

34 35 36 37 38 39 40 41
/**
 * \defgroup access Access
 * @{
 */

enum access_query_e
{
    /* capabilities */
42 43 44 45
    ACCESS_CAN_SEEK,        /* arg1= bool*    cannot fail */
    ACCESS_CAN_FASTSEEK,    /* arg1= bool*    cannot fail */
    ACCESS_CAN_PAUSE,       /* arg1= bool*    cannot fail */
    ACCESS_CAN_CONTROL_PACE,/* arg1= bool*    cannot fail */
46 47

    /* */
48
    ACCESS_GET_PTS_DELAY = 0x101,/* arg1= int64_t*       cannot fail */
49
    /* */
50
    ACCESS_GET_TITLE_INFO,  /* arg1=input_title_t*** arg2=int*      res=can fail */
51
    /* Meta data */
52
    ACCESS_GET_META,        /* arg1= vlc_meta_t **                  res=can fail */
53 54

    /* */
55 56 57 58 59 60
    ACCESS_GET_CONTENT_TYPE,/* arg1=char **ppsz_content_type                       res=can fail */

    /* */
    ACCESS_GET_SIGNAL,      /* arg1=double *pf_quality, arg2=double *pf_strength   res=can fail */

    /* */
61
    ACCESS_SET_PAUSE_STATE = 0x200, /* arg1= bool           can fail */
62 63 64 65 66 67 68

    /* */
    ACCESS_SET_TITLE,       /* arg1= int            can fail */
    ACCESS_SET_SEEKPOINT,   /* arg1= int            can fail */

    /* Special mode for access/demux communication
     * XXX: avoid to use it unless you can't */
69 70 71
    ACCESS_SET_PRIVATE_ID_STATE = 0x1000, /* arg1= int i_private_data, bool b_selected    res=can fail */
    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 */
    ACCESS_GET_PRIVATE_ID_STATE,          /* arg1=int i_private_data arg2=bool *          res=can fail */
72 73 74 75 76 77 78 79 80 81 82
};

struct access_t
{
    VLC_COMMON_MEMBERS

    /* Module properties */
    module_t    *p_module;

    /* Access name (empty if non forced) */
    char        *psz_access;
83
    char        *psz_location; /**< Location (URL with the scheme stripped) */
84
    char        *psz_filepath; /**< Local file path (if applicable) */
85 86

    /* Access can fill this entry to force a demuxer
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
87
     * XXX: fill it once you know for sure you will succeed
88 89 90 91 92
     * (if you fail, this value won't be reseted */
    char        *psz_demux;

    /* pf_read/pf_block is used to read data.
     * XXX A access should set one and only one of them */
93
    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 */
94 95 96 97
    block_t    *(*pf_block)( access_t * );                  /* return a block of data in his 'natural' size, NULL if not yet data or eof */

    /* Called for each seek.
     * XXX can be null */
98
    int         (*pf_seek) ( access_t *, uint64_t );         /* can be null if can't seek */
99 100 101 102 103 104 105 106 107 108 109

    /* Used to retreive and configure the access
     * XXX mandatory. look at access_query_e to know what query you *have to* support */
    int         (*pf_control)( access_t *, int i_query, va_list args);

    /* Access has to maintain them uptodate */
    struct
    {
        unsigned int i_update;  /* Access sets them on change,
                                   Input removes them once take into account*/

110 111
        uint64_t     i_size;    /* Write only for access, read only for input */
        uint64_t     i_pos;     /* idem */
112
        bool         b_eof;     /* idem */
113 114 115 116 117

        int          i_title;    /* idem, start from 0 (could be menu) */
        int          i_seekpoint;/* idem, start from 0 */
    } info;
    access_sys_t *p_sys;
118 119 120

    /* Weak link to parent input */
    input_thread_t *p_input;
121 122
};

123
static inline int access_vaControl( access_t *p_access, int i_query, va_list args )
124
{
125
    if( !p_access ) return VLC_EGENERIC;
126 127
    return p_access->pf_control( p_access, i_query, args );
}
128

129
static inline int access_Control( access_t *p_access, int i_query, ... )
130 131 132 133 134
{
    va_list args;
    int     i_result;

    va_start( args, i_query );
135
    i_result = access_vaControl( p_access, i_query, args );
136 137 138 139
    va_end( args );
    return i_result;
}

Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
140
static inline void access_InitFields( access_t *p_a )
141 142 143 144
{
    p_a->info.i_update = 0;
    p_a->info.i_size = 0;
    p_a->info.i_pos = 0;
145
    p_a->info.b_eof = false;
146 147 148 149
    p_a->info.i_title = 0;
    p_a->info.i_seekpoint = 0;
}

150 151 152 153
/**
 * This function will return the parent input of this access.
 * It is retained. It can return NULL.
 */
154
VLC_API input_thread_t * access_GetParentInput( access_t *p_access ) VLC_USED;
155

156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172
#define ACCESS_SET_CALLBACKS( read, block, control, seek )              \
    p_access->pf_read = read;                                           \
    p_access->pf_block = block;                                         \
    p_access->pf_control = control;                                     \
    p_access->pf_seek = seek;

#define STANDARD_READ_ACCESS_INIT                                       \
    access_InitFields( p_access );                                      \
    ACCESS_SET_CALLBACKS( Read, NULL, Control, Seek );                  \
    p_sys = p_access->p_sys = calloc( 1, sizeof( access_sys_t ));       \
    if( !p_sys ) return VLC_ENOMEM;

#define STANDARD_BLOCK_ACCESS_INIT                                      \
    access_InitFields( p_access );                                      \
    ACCESS_SET_CALLBACKS( NULL, Block, Control, Seek );                 \
    p_sys = p_access->p_sys = calloc( 1, sizeof( access_sys_t ) );      \
    if( !p_sys ) return VLC_ENOMEM;
173

174 175 176 177
/**
 * @}
 */

178
#endif