git.sesse.net Git - vlc/blob - plugins/null/null.c

   1 /*****************************************************************************
   2  * null.c : NULL module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2000 VideoLAN
   5  *
   6  * Authors: Samuel Hocevar <sam@zoy.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  21  *****************************************************************************/
  22
  23 #define MODULE_NAME null
  24
  25 /*****************************************************************************
  26  * Preamble
  27  *****************************************************************************/
  28 #include "defs.h"
  29
  30 #include <stdlib.h>                                      /* malloc(), free() */
  31 #include <string.h>                                              /* strdup() */
  32
  33 #include "config.h"
  34 #include "common.h"                                     /* boolean_t, byte_t */
  35 #include "threads.h"
  36 #include "mtime.h"
  37 #include "tests.h"
  38
  39 #include "modules.h"
  40 #include "modules_inner.h"
  41
  42 /*****************************************************************************
  43  * Build configuration tree.
  44  *****************************************************************************/
  45 MODULE_CONFIG_START
  46 ADD_WINDOW( "Configuration for null module" )
  47     ADD_PANE( "First pane" )
  48         ADD_FRAME( "First frame" )
  49             ADD_COMMENT( "You can put whatever you want here." )
  50             ADD_STRING( "Random text: ", MODULE_VAR(text), NULL )
  51         ADD_FRAME( "Second frame" )
  52             ADD_COMMENT( "The file below is not used." )
  53             ADD_FILE( "Select file: ", MODULE_VAR(file), NULL )
  54         ADD_FRAME( "Third frame" )
  55             ADD_COMMENT( "This space intentionally left blank." )
  56     ADD_PANE( "Second pane" )
  57         ADD_FRAME( "Frame" )
  58             ADD_COMMENT( "There is nothing in this frame." )
  59 MODULE_CONFIG_END
  60
  61 /*****************************************************************************
  62  * InitModule: get the module structure and configuration.
  63  *****************************************************************************
  64  * We have to fill psz_name, psz_longname and psz_version. These variables
  65  * will be strdup()ed later by the main application because the module can
  66  * be unloaded later to save memory, and we want to be able to access this
  67  * data even after the module has been unloaded.
  68  *****************************************************************************/
  69 int InitModule( module_t * p_module )
  70 {
  71     p_module->psz_name = MODULE_STRING;
  72     p_module->psz_longname = "the Null module that does nothing";
  73     p_module->psz_version = VERSION;
  74
  75     p_module->i_capabilities = MODULE_CAPABILITY_NULL;
  76
  77     return( 0 );
  78 }
  79
  80 /*****************************************************************************
  81  * ActivateModule: set the module to an usable state.
  82  *****************************************************************************
  83  * This function fills the capability functions and the configuration
  84  * structure. Once ActivateModule() has been called, the i_usage can
  85  * be set to 0 and calls to NeedModule() be made to increment it. To unload
  86  * the module, one has to wait until i_usage == 0 and call DeactivateModule().
  87  *****************************************************************************/
  88 int ActivateModule( module_t * p_module )
  89 {
  90     /* Since the Null module can't do anything, there is no need to
  91      * fill the p_functions structure. */
  92     p_module->p_functions = NULL;
  93     p_module->p_config = p_config;
  94
  95     return( 0 );
  96 }
  97
  98 /*****************************************************************************
  99  * DeactivateModule: make sure the module can be unloaded.
 100  *****************************************************************************
 101  * This function must only be called when i_usage == 0. If it successfully
 102  * returns, i_usage can be set to -1 and the module unloaded. Be careful to
 103  * lock usage_lock during the whole process.
 104  *****************************************************************************/
 105 int DeactivateModule( module_t * p_module )
 106 {
 107     /* We didn't allocate p_functions - so we don't have to free it */
 108     return( 0 );
 109 }
 110