X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=include%2Fvlc_block.h;h=fda20ce6434cf440ba271a54156dcd921b2a76d4;hb=262c049bddab97077b49e00600a33ccd242d052d;hp=d673ce25f5a1ad949bdd941e325d60ea63435bfa;hpb=3c01122ead0439d87bcaae4a3b5a32f28a50e940;p=vlc diff --git a/include/vlc_block.h b/include/vlc_block.h index d673ce25f5..fda20ce643 100644 --- a/include/vlc_block.h +++ b/include/vlc_block.h @@ -1,7 +1,7 @@ /***************************************************************************** * vlc_block.h: Data blocks management functions ***************************************************************************** - * Copyright (C) 2003 VideoLAN + * Copyright (C) 2003 the VideoLAN team * $Id$ * * Authors: Laurent Aimar @@ -18,9 +18,13 @@ * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. *****************************************************************************/ +#if !defined( __LIBVLC__ ) + #error You are not libvlc or one of its plugins. You cannot include this file +#endif + #ifndef _VLC_BLOCK_H #define _VLC_BLOCK_H 1 @@ -56,7 +60,7 @@ typedef struct block_sys_t block_sys_t; #define BLOCK_FLAG_TYPE_B 0x0008 /** For inter frame when you don't know the real type */ #define BLOCK_FLAG_TYPE_PB 0x0010 -/** Warm that this block is a header one */ +/** Warn that this block is a header one */ #define BLOCK_FLAG_HEADER 0x0020 /** This is the last block of the frame */ #define BLOCK_FLAG_END_OF_FRAME 0x0040 @@ -74,9 +78,12 @@ typedef struct block_sys_t block_sys_t; #define BLOCK_FLAG_PRIVATE_MASK 0xffff0000 #define BLOCK_FLAG_PRIVATE_SHIFT 16 +typedef void (*block_free_t) (block_t *); + struct block_t { block_t *p_next; + block_t *p_prev; uint32_t i_flags; @@ -87,22 +94,11 @@ struct block_t int i_samples; /* Used for audio */ int i_rate; - int i_buffer; + size_t i_buffer; uint8_t *p_buffer; - /* This way the block_Release can be overloaded - * Don't mess with it now, if you need it the ask on ML - */ - void (*pf_release) ( block_t * ); - - /* It's an object that should be valid as long as the block_t is valid */ - /* It should become a true block manager to reduce malloc/free */ - vlc_object_t *p_manager; - - /* Following fields are private, user should never touch it */ - /* XXX never touch that OK !!! the first that access that will - * have cvs account removed ;) XXX */ - block_sys_t *p_sys; + /* Rudimentary support for overloading block (de)allocation. */ + block_free_t pf_release; }; /**************************************************************************** @@ -121,13 +117,21 @@ struct block_t * and decrease are supported). Use it as it is optimised. * - block_Duplicate : create a copy of a block. ****************************************************************************/ -#define block_New( a, b ) __block_New( VLC_OBJECT(a), b ) -VLC_EXPORT( block_t *, __block_New, ( vlc_object_t *, int ) ); -VLC_EXPORT( block_t *, block_Realloc, ( block_t *, int i_pre, int i_body ) ); +VLC_EXPORT( void, block_Init, ( block_t *, void *, size_t ) ); +VLC_EXPORT( block_t *, block_Alloc, ( size_t ) ); +VLC_EXPORT( block_t *, block_Realloc, ( block_t *, ssize_t i_pre, size_t i_body ) ); + +static inline block_t *block_New( void *dummy, size_t size ) +{ + (void)dummy; + return block_Alloc (size); +} static inline block_t *block_Duplicate( block_t *p_block ) { - block_t *p_dup = block_New( p_block->p_manager, p_block->i_buffer ); + block_t *p_dup = block_New( NULL, p_block->i_buffer ); + if( p_dup == NULL ) + return NULL; p_dup->i_dts = p_block->i_dts; p_dup->i_pts = p_block->i_pts; @@ -135,9 +139,7 @@ static inline block_t *block_Duplicate( block_t *p_block ) p_dup->i_length = p_block->i_length; p_dup->i_rate = p_block->i_rate; p_dup->i_samples = p_block->i_samples; - - if( p_dup && p_block->i_buffer > 0 ) - memcpy( p_dup->p_buffer, p_block->p_buffer, p_block->i_buffer ); + memcpy( p_dup->p_buffer, p_block->p_buffer, p_block->i_buffer ); return p_dup; } @@ -146,6 +148,18 @@ static inline void block_Release( block_t *p_block ) p_block->pf_release( p_block ); } +/** + * Creates a block from a virtual address memory mapping (mmap). + * This is provided by LibVLC so that mmap blocks can safely be deallocated + * even after the allocating plugin has been unloaded from memory. + * + * @param addr base address of the mapping (as returned by mmap) + * @param length length (bytes) of the mapping (as passed to mmap) + * @return NULL if addr is MAP_FAILED, or an error occurred (in the later + * case, munmap(addr, length) is invoked before returning). + */ +VLC_EXPORT( block_t *, block_mmap_Alloc, (void *addr, size_t length) ); + /**************************************************************************** * Chains of blocks functions helper **************************************************************************** @@ -192,32 +206,28 @@ static inline void block_ChainRelease( block_t *p_block ) p_block = p_next; } } -static int block_ChainExtract( block_t *p_list, void *p_data, int i_max ) + +static size_t block_ChainExtract( block_t *p_list, void *p_data, size_t i_max ) { - block_t *b; - int i_total = 0; + size_t i_total = 0; uint8_t *p = (uint8_t*)p_data; - for( b = p_list; b != NULL; b = b->p_next ) + while( p_list && i_max ) { - int i_copy = __MIN( i_max, b->i_buffer ); - if( i_copy > 0 ) - { - memcpy( p, b->p_buffer, i_copy ); - i_max -= i_copy; - i_total += i_copy; - p += i_copy; - - if( i_max == 0 ) - return i_total; - } + size_t i_copy = __MIN( i_max, p_list->i_buffer ); + memcpy( p, p_list->p_buffer, i_copy ); + i_max -= i_copy; + i_total += i_copy; + p += i_copy; + + p_list = p_list->p_next; } return i_total; } static inline block_t *block_ChainGather( block_t *p_list ) { - int i_total = 0; + size_t i_total = 0; mtime_t i_length = 0; block_t *b, *g; @@ -230,7 +240,7 @@ static inline block_t *block_ChainGather( block_t *p_list ) i_length += b->i_length; } - g = block_New( p_list->p_manager, i_total ); + g = block_New( NULL, i_total ); block_ChainExtract( p_list, g->p_buffer, g->i_buffer ); g->i_flags = p_list->i_flags; @@ -247,35 +257,29 @@ static inline block_t *block_ChainGather( block_t *p_list ) /**************************************************************************** * Fifos of blocks. **************************************************************************** - * Avoid touching block_fifo_t unless you really know what you are doing. - * ( Some race conditions has to be correctly handled, like in win32 ;) * - block_FifoNew : create and init a new fifo * - block_FifoRelease : destroy a fifo and free all blocks in it. * - block_FifoEmpty : free all blocks in a fifo * - block_FifoPut : put a block * - block_FifoGet : get a packet from the fifo (and wait if it is empty) * - block_FifoShow : show the first packet of the fifo (and wait if - * needed), becarefull, you can use it ONLY if you are sure to be the + * needed), be carefull, you can use it ONLY if you are sure to be the * only one getting data from the fifo. + * - block_FifoCount : how many packets are waiting in the fifo + * - block_FifoSize : how many cumulated bytes are waiting in the fifo + * - block_FifoWake : wake ups a thread with block_FifoGet() = NULL + * (this is used to wakeup a thread when there is no data to queue) ****************************************************************************/ -struct block_fifo_t -{ - vlc_mutex_t lock; /* fifo data lock */ - vlc_cond_t wait; /* fifo data conditional variable */ - - int i_depth; - block_t *p_first; - block_t **pp_last; - int i_size; -}; - #define block_FifoNew( a ) __block_FifoNew( VLC_OBJECT(a) ) VLC_EXPORT( block_fifo_t *, __block_FifoNew, ( vlc_object_t * ) ); VLC_EXPORT( void, block_FifoRelease, ( block_fifo_t * ) ); VLC_EXPORT( void, block_FifoEmpty, ( block_fifo_t * ) ); -VLC_EXPORT( int, block_FifoPut, ( block_fifo_t *, block_t * ) ); +VLC_EXPORT( size_t, block_FifoPut, ( block_fifo_t *, block_t * ) ); +VLC_EXPORT( void, block_FifoWake, ( block_fifo_t * ) ); VLC_EXPORT( block_t *, block_FifoGet, ( block_fifo_t * ) ); VLC_EXPORT( block_t *, block_FifoShow, ( block_fifo_t * ) ); +VLC_EXPORT( size_t, block_FifoSize, ( const block_fifo_t *p_fifo ) ); +VLC_EXPORT( size_t, block_FifoCount, ( const block_fifo_t *p_fifo ) ); #endif /* VLC_BLOCK_H */