2004-06-22 21:29:37 +02:00
|
|
|
/*****************************************************************************
|
2005-12-15 12:37:45 +01:00
|
|
|
* vlc_access.h: Access descriptor, queries and methods
|
2004-06-22 21:29:37 +02:00
|
|
|
*****************************************************************************
|
2006-09-09 11:23:02 +02:00
|
|
|
* Copyright (C) 1999-2006 the VideoLAN team
|
2004-08-25 20:50:36 +02:00
|
|
|
* $Id$
|
2004-06-22 21:29:37 +02:00
|
|
|
*
|
|
|
|
* 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
|
2006-01-13 00:10:04 +01:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
2004-06-22 21:29:37 +02:00
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef _VLC_ACCESS_H
|
|
|
|
#define _VLC_ACCESS_H 1
|
|
|
|
|
2006-11-26 15:20:34 +01:00
|
|
|
#include <vlc_block.h>
|
|
|
|
|
2004-06-22 21:29:37 +02:00
|
|
|
/**
|
|
|
|
* \defgroup access Access
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
enum access_query_e
|
|
|
|
{
|
|
|
|
/* capabilities */
|
2008-04-14 00:08:29 +02:00
|
|
|
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 */
|
2004-06-22 21:29:37 +02:00
|
|
|
|
|
|
|
/* */
|
|
|
|
ACCESS_GET_MTU, /* arg1= int* cannot fail(0 if no sense)*/
|
|
|
|
ACCESS_GET_PTS_DELAY, /* arg1= int64_t* cannot fail */
|
|
|
|
/* */
|
2004-08-25 20:50:36 +02:00
|
|
|
ACCESS_GET_TITLE_INFO, /* arg1=input_title_t*** arg2=int* can fail */
|
|
|
|
/* Meta data */
|
|
|
|
ACCESS_GET_META, /* arg1= vlc_meta_t ** res=can fail */
|
2004-06-22 21:29:37 +02:00
|
|
|
|
|
|
|
/* */
|
2008-04-14 00:08:29 +02:00
|
|
|
ACCESS_SET_PAUSE_STATE, /* arg1= bool can fail */
|
2004-06-22 21:29:37 +02:00
|
|
|
|
|
|
|
/* */
|
|
|
|
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 */
|
2008-04-14 00:08:29 +02:00
|
|
|
ACCESS_SET_PRIVATE_ID_STATE, /* arg1= int i_private_data, bool b_selected can fail */
|
2004-09-03 20:42:25 +02:00
|
|
|
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 */
|
2008-04-14 00:08:29 +02:00
|
|
|
ACCESS_GET_PRIVATE_ID_STATE, /* arg1=int i_private_data arg2=bool * res=can fail */
|
2007-10-02 17:54:16 +02:00
|
|
|
|
|
|
|
ACCESS_GET_CONTENT_TYPE, /* arg1=char **ppsz_content_type */
|
2004-06-22 21:29:37 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
struct access_t
|
|
|
|
{
|
|
|
|
VLC_COMMON_MEMBERS
|
|
|
|
|
|
|
|
/* Module properties */
|
|
|
|
module_t *p_module;
|
|
|
|
|
|
|
|
/* Access name (empty if non forced) */
|
|
|
|
char *psz_access;
|
|
|
|
/* Access path/url/filename/.... */
|
|
|
|
char *psz_path;
|
2005-03-29 18:01:23 +02:00
|
|
|
/* Access source for access_filter (NULL for regular access) */
|
|
|
|
access_t *p_source;
|
2004-06-22 21:29:37 +02:00
|
|
|
|
|
|
|
/* Access can fill this entry to force a demuxer
|
2006-09-09 11:23:02 +02:00
|
|
|
* XXX: fill it once you know for sure you will succeed
|
2004-06-22 21:29:37 +02:00
|
|
|
* (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 */
|
2007-12-09 18:39:28 +01:00
|
|
|
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 */
|
2004-06-22 21:29:37 +02:00
|
|
|
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 */
|
|
|
|
int (*pf_seek) ( access_t *, int64_t ); /* can be null if can't seek */
|
|
|
|
|
|
|
|
/* 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*/
|
|
|
|
|
|
|
|
int64_t i_size; /* Write only for access, read only for input */
|
|
|
|
int64_t i_pos; /* idem */
|
2008-04-14 00:08:29 +02:00
|
|
|
bool b_eof; /* idem */
|
2004-06-22 21:29:37 +02:00
|
|
|
|
|
|
|
int i_title; /* idem, start from 0 (could be menu) */
|
|
|
|
int i_seekpoint;/* idem, start from 0 */
|
2005-10-24 19:08:54 +02:00
|
|
|
|
2008-04-14 00:08:29 +02:00
|
|
|
bool b_prebuffered; /* Read only for input */
|
2004-06-22 21:29:37 +02:00
|
|
|
} info;
|
|
|
|
access_sys_t *p_sys;
|
|
|
|
};
|
|
|
|
|
2008-04-14 00:21:18 +02:00
|
|
|
static inline int access_vaControl( access_t *p_access, int i_query, va_list args )
|
2004-06-22 21:29:37 +02:00
|
|
|
{
|
2008-03-13 16:18:35 +01:00
|
|
|
if( !p_access ) return VLC_EGENERIC;
|
2004-06-22 21:29:37 +02:00
|
|
|
return p_access->pf_control( p_access, i_query, args );
|
|
|
|
}
|
2006-11-26 15:20:34 +01:00
|
|
|
|
2008-04-14 00:21:18 +02:00
|
|
|
static inline int access_Control( access_t *p_access, int i_query, ... )
|
2004-06-22 21:29:37 +02:00
|
|
|
{
|
|
|
|
va_list args;
|
|
|
|
int i_result;
|
|
|
|
|
|
|
|
va_start( args, i_query );
|
2008-04-14 00:21:18 +02:00
|
|
|
i_result = access_vaControl( p_access, i_query, args );
|
2004-06-22 21:29:37 +02:00
|
|
|
va_end( args );
|
|
|
|
return i_result;
|
|
|
|
}
|
|
|
|
|
2007-10-02 17:54:16 +02:00
|
|
|
static inline char *access_GetContentType( access_t *p_access )
|
|
|
|
{
|
|
|
|
char *res;
|
2008-04-14 00:21:18 +02:00
|
|
|
if( access_Control( p_access, ACCESS_GET_CONTENT_TYPE, &res ) )
|
2007-10-02 17:54:16 +02:00
|
|
|
return NULL;
|
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
2006-08-01 17:00:50 +02:00
|
|
|
static inline void access_InitFields( access_t *p_a )
|
2006-07-19 11:33:41 +02:00
|
|
|
{
|
|
|
|
p_a->info.i_update = 0;
|
|
|
|
p_a->info.i_size = 0;
|
|
|
|
p_a->info.i_pos = 0;
|
2008-04-14 00:08:29 +02:00
|
|
|
p_a->info.b_eof = false;
|
2006-07-19 11:33:41 +02:00
|
|
|
p_a->info.i_title = 0;
|
|
|
|
p_a->info.i_seekpoint = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
#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 ); \
|
|
|
|
MALLOC_ERR( p_access->p_sys, access_sys_t ); \
|
|
|
|
p_sys = p_access->p_sys; memset( p_sys, 0, sizeof( access_sys_t ) );
|
|
|
|
|
|
|
|
#define STANDARD_BLOCK_ACCESS_INIT \
|
|
|
|
access_InitFields( p_access ); \
|
|
|
|
ACCESS_SET_CALLBACKS( NULL, Block, Control, Seek ); \
|
|
|
|
MALLOC_ERR( p_access->p_sys, access_sys_t ); \
|
|
|
|
p_sys = p_access->p_sys; memset( p_sys, 0, sizeof( access_sys_t ) );
|
|
|
|
|
2004-06-22 21:29:37 +02:00
|
|
|
#endif
|