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

   1 /*****************************************************************************
   2  * dsp.c : OSS /dev/dsp module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2000 VideoLAN
   5  * $Id: dsp.c,v 1.8 2001/03/21 13:42:33 sam Exp $
   6  *
   7  * Authors: Michel Kaempf <maxx@via.ecp.fr>
   8  *          Samuel Hocevar <sam@zoy.org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  23  *****************************************************************************/
  24
  25 #define MODULE_NAME dsp
  26 #include "modules_inner.h"
  27
  28 /*****************************************************************************
  29  * Preamble
  30  *****************************************************************************/
  31 #include "defs.h"
  32
  33 #include <stdlib.h>                                      /* malloc(), free() */
  34 #include <string.h>                                              /* strdup() */
  35
  36 #include "config.h"
  37 #include "common.h"                                     /* boolean_t, byte_t */
  38 #include "threads.h"
  39 #include "mtime.h"
  40
  41 #include "modules.h"
  42
  43 /*****************************************************************************
  44  * Build configuration tree.
  45  *****************************************************************************/
  46 MODULE_CONFIG_START
  47 ADD_WINDOW( "Configuration for dsp module" )
  48     ADD_FRAME( "OSS Device" )
  49         ADD_FILE( "Device name: ", MODULE_VAR(device), NULL )
  50 MODULE_CONFIG_END
  51
  52 /*****************************************************************************
  53  * Capabilities defined in the other files.
  54  *****************************************************************************/
  55 void _M( aout_getfunctions )( function_list_t * p_function_list );
  56
  57 /*****************************************************************************
  58  * InitModule: get the module structure and configuration.
  59  *****************************************************************************
  60  * We have to fill psz_name, psz_longname and psz_version. These variables
  61  * will be strdup()ed later by the main application because the module can
  62  * be unloaded later to save memory, and we want to be able to access this
  63  * data even after the module has been unloaded.
  64  *****************************************************************************/
  65 MODULE_INIT
  66 {
  67     p_module->psz_name = MODULE_STRING;
  68     p_module->psz_longname = "Linux OSS /dev/dsp module";
  69     p_module->psz_version = VERSION;
  70
  71     p_module->i_capabilities = MODULE_CAPABILITY_NULL
  72                                 | MODULE_CAPABILITY_AOUT;
  73
  74     return( 0 );
  75 }
  76
  77 /*****************************************************************************
  78  * ActivateModule: set the module to an usable state.
  79  *****************************************************************************
  80  * This function fills the capability functions and the configuration
  81  * structure. Once ActivateModule() has been called, the i_usage can
  82  * be set to 0 and calls to NeedModule() be made to increment it. To unload
  83  * the module, one has to wait until i_usage == 0 and call DeactivateModule().
  84  *****************************************************************************/
  85 MODULE_ACTIVATE
  86 {
  87     p_module->p_functions = malloc( sizeof( module_functions_t ) );
  88     if( p_module->p_functions == NULL )
  89     {
  90         return( -1 );
  91     }
  92
  93     _M( aout_getfunctions )( &p_module->p_functions->aout );
  94
  95     p_module->p_config = p_config;
  96
  97     return( 0 );
  98 }
  99
 100 /*****************************************************************************
 101  * DeactivateModule: make sure the module can be unloaded.
 102  *****************************************************************************
 103  * This function must only be called when i_usage == 0. If it successfully
 104  * returns, i_usage can be set to -1 and the module unloaded. Be careful to
 105  * lock usage_lock during the whole process.
 106  *****************************************************************************/
 107 MODULE_DEACTIVATE
 108 {
 109     free( p_module->p_functions );
 110
 111     return( 0 );
 112 }
 113