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

   1 /*****************************************************************************
   2  * vlc_probe.h: service probing interface
   3  *****************************************************************************
   4  * Copyright (C) 2009 Rémi Denis-Courmont
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU Lesser General Public License as published by
   8  * the Free Software Foundation; either version 2.1 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  19  *****************************************************************************/
  20
  21 #ifndef VLC_PROBE_H
  22 # define VLC_PROBE_H 1
  23
  24 # include <stdlib.h>
  25
  26 /**
  27  * \file
  28  * This file defines functions and structures to run-time probe VLC extensions
  29  */
  30
  31 # ifdef __cplusplus
  32 extern "C" {
  33 # endif
  34
  35 VLC_EXPORT(void *, vlc_probe, (vlc_object_t *, const char *,
  36                                size_t *restrict));
  37 #define vlc_probe(obj, cap, pcount) \
  38         vlc_probe(VLC_OBJECT(obj), cap, pcount)
  39
  40 struct vlc_probe_t
  41 {
  42     VLC_COMMON_MEMBERS
  43
  44     void  *list;
  45     size_t count;
  46 };
  47
  48 typedef struct vlc_probe_t vlc_probe_t;
  49
  50 static inline int vlc_probe_add(vlc_probe_t *obj, const void *data,
  51                                 size_t len)
  52 {
  53     char *tab = (char *)realloc (obj->list, (obj->count + 1) * len);
  54
  55     if (unlikely(tab == NULL))
  56         return VLC_ENOMEM;
  57     memcpy(tab + (obj->count * len), data, len);
  58     obj->list = tab;
  59     obj->count++;
  60     return VLC_SUCCESS;
  61 }
  62
  63 # define VLC_PROBE_CONTINUE VLC_EGENERIC
  64 # define VLC_PROBE_STOP     VLC_SUCCESS
  65
  66 # ifdef __cplusplus
  67 }
  68 # endif
  69
  70 #endif