src/audio/SDL_sysaudio.h
author Ryan C. Gordon
Tue, 03 Oct 2006 16:26:42 +0000
branchSDL-ryan-multiple-audio-device
changeset 3787 8d74a4721ca9
parent 3784 37c9c4590689
child 3790 8f8209f8da6d
permissions -rw-r--r--
Added deinitialize hook.
slouken@0
     1
/*
slouken@0
     2
    SDL - Simple DirectMedia Layer
slouken@1312
     3
    Copyright (C) 1997-2006 Sam Lantinga
slouken@0
     4
slouken@1336
     5
    This library is SDL_free software; you can redistribute it and/or
slouken@1312
     6
    modify it under the terms of the GNU Lesser General Public
slouken@0
     7
    License as published by the Free Software Foundation; either
slouken@1312
     8
    version 2.1 of the License, or (at your option) any later version.
slouken@0
     9
slouken@0
    10
    This library is distributed in the hope that it will be useful,
slouken@0
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@0
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@1312
    13
    Lesser General Public License for more details.
slouken@0
    14
slouken@1312
    15
    You should have received a copy of the GNU Lesser General Public
slouken@1312
    16
    License along with this library; if not, write to the Free Software
slouken@1312
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
slouken@0
    18
slouken@0
    19
    Sam Lantinga
slouken@252
    20
    slouken@libsdl.org
slouken@0
    21
*/
slouken@1402
    22
#include "SDL_config.h"
slouken@0
    23
slouken@0
    24
#ifndef _SDL_sysaudio_h
slouken@0
    25
#define _SDL_sysaudio_h
slouken@0
    26
slouken@0
    27
#include "SDL_mutex.h"
slouken@0
    28
#include "SDL_thread.h"
slouken@0
    29
slouken@0
    30
/* The SDL audio driver */
slouken@0
    31
typedef struct SDL_AudioDevice SDL_AudioDevice;
icculus@3784
    32
#define _THIS	SDL_AudioDevice *_this
slouken@0
    33
icculus@3784
    34
/* !!! FIXME: rename these from "Audio" to "Device" ... */
icculus@3784
    35
typedef struct SDL_AudioDriverImpl
icculus@3784
    36
{
icculus@3784
    37
    int (*OpenAudio) (_THIS, const char *devname, int iscapture);
icculus@3784
    38
    void (*ThreadInit) (_THIS); /* Called by audio thread at start */
icculus@3784
    39
    void (*WaitAudio) (_THIS);
icculus@3784
    40
    void (*PlayAudio) (_THIS);
icculus@3784
    41
    Uint8 *(*GetAudioBuf) (_THIS);
icculus@3784
    42
    void (*WaitDone) (_THIS);
icculus@3784
    43
    void (*CloseAudio) (_THIS);
icculus@3784
    44
    void (*LockAudio) (_THIS);
icculus@3784
    45
    void (*UnlockAudio) (_THIS);
icculus@3787
    46
    void (*Deinitialize) (void);
icculus@3784
    47
} SDL_AudioDriverImpl;
icculus@3784
    48
icculus@3784
    49
typedef struct SDL_AudioDriver
slouken@1895
    50
{
slouken@1895
    51
    /* * * */
slouken@1895
    52
    /* The name of this audio driver */
slouken@1895
    53
    const char *name;
slouken@0
    54
slouken@1895
    55
    /* * * */
slouken@1895
    56
    /* The description of this audio driver */
slouken@1895
    57
    const char *desc;
slouken@0
    58
icculus@3784
    59
    SDL_AudioDriverImpl impl;
icculus@3784
    60
} SDL_AudioDriver;
icculus@3784
    61
icculus@3784
    62
icculus@3784
    63
/* Define the SDL audio driver structure */
icculus@3784
    64
struct SDL_AudioDevice
icculus@3784
    65
{
slouken@1895
    66
    /* * * */
icculus@3784
    67
    /* Lowlevel audio implementation */
icculus@3784
    68
    const SDL_AudioDriver *driver;
slouken@322
    69
slouken@1895
    70
    /* * * */
slouken@1895
    71
    /* Data common to all devices */
slouken@0
    72
slouken@1895
    73
    /* The current audio specification (shared with audio thread) */
slouken@1895
    74
    SDL_AudioSpec spec;
slouken@0
    75
slouken@1895
    76
    /* An audio conversion block for audio format emulation */
slouken@1895
    77
    SDL_AudioCVT convert;
slouken@0
    78
slouken@1895
    79
    /* Current state flags */
slouken@1895
    80
    int enabled;
slouken@1895
    81
    int paused;
slouken@1895
    82
    int opened;
slouken@0
    83
slouken@1895
    84
    /* Fake audio buffer for when the audio hardware is busy */
slouken@1895
    85
    Uint8 *fake_stream;
slouken@0
    86
slouken@1895
    87
    /* A semaphore for locking the mixing buffers */
slouken@1895
    88
    SDL_mutex *mixer_lock;
slouken@0
    89
slouken@1895
    90
    /* A thread to feed the audio device */
slouken@1895
    91
    SDL_Thread *thread;
slouken@1895
    92
    Uint32 threadid;
slouken@0
    93
slouken@1895
    94
    /* * * */
slouken@1895
    95
    /* Data private to this driver */
slouken@1895
    96
    struct SDL_PrivateAudioData *hidden;
slouken@0
    97
slouken@1895
    98
    /* * * */
slouken@1895
    99
    /* The function used to dispose of this structure */
slouken@1895
   100
    void (*free) (_THIS);
slouken@0
   101
};
slouken@0
   102
#undef _THIS
slouken@0
   103
slouken@1895
   104
typedef struct AudioBootStrap
slouken@1895
   105
{
slouken@1895
   106
    const char *name;
slouken@1895
   107
    const char *desc;
slouken@1895
   108
    int (*available) (void);
icculus@3784
   109
    int (*init) (SDL_AudioDriverImpl *impl);
slouken@0
   110
} AudioBootStrap;
slouken@0
   111
slouken@1567
   112
#if SDL_AUDIO_DRIVER_BSD
slouken@1567
   113
extern AudioBootStrap BSD_AUDIO_bootstrap;
slouken@94
   114
#endif
slouken@1361
   115
#if SDL_AUDIO_DRIVER_OSS
slouken@0
   116
extern AudioBootStrap DSP_bootstrap;
slouken@0
   117
extern AudioBootStrap DMA_bootstrap;
slouken@0
   118
#endif
slouken@1361
   119
#if SDL_AUDIO_DRIVER_ALSA
slouken@0
   120
extern AudioBootStrap ALSA_bootstrap;
slouken@0
   121
#endif
slouken@1361
   122
#if SDL_AUDIO_DRIVER_QNXNTO
slouken@663
   123
extern AudioBootStrap QNXNTOAUDIO_bootstrap;
slouken@663
   124
#endif
slouken@1361
   125
#if SDL_AUDIO_DRIVER_SUNAUDIO
slouken@148
   126
extern AudioBootStrap SUNAUDIO_bootstrap;
slouken@148
   127
#endif
slouken@1361
   128
#if SDL_AUDIO_DRIVER_DMEDIA
slouken@148
   129
extern AudioBootStrap DMEDIA_bootstrap;
slouken@35
   130
#endif
slouken@1361
   131
#if SDL_AUDIO_DRIVER_ARTS
slouken@1361
   132
extern AudioBootStrap ARTS_bootstrap;
slouken@0
   133
#endif
slouken@1361
   134
#if SDL_AUDIO_DRIVER_ESD
slouken@0
   135
extern AudioBootStrap ESD_bootstrap;
slouken@0
   136
#endif
slouken@1361
   137
#if SDL_AUDIO_DRIVER_NAS
slouken@0
   138
extern AudioBootStrap NAS_bootstrap;
slouken@0
   139
#endif
slouken@1361
   140
#if SDL_AUDIO_DRIVER_DSOUND
slouken@0
   141
extern AudioBootStrap DSOUND_bootstrap;
slouken@0
   142
#endif
slouken@1361
   143
#if SDL_AUDIO_DRIVER_WAVEOUT
slouken@0
   144
extern AudioBootStrap WAVEOUT_bootstrap;
slouken@0
   145
#endif
slouken@1361
   146
#if SDL_AUDIO_DRIVER_PAUD
slouken@21
   147
extern AudioBootStrap Paud_bootstrap;
slouken@21
   148
#endif
slouken@1361
   149
#if SDL_AUDIO_DRIVER_BAUDIO
slouken@0
   150
extern AudioBootStrap BAUDIO_bootstrap;
slouken@0
   151
#endif
slouken@1361
   152
#if SDL_AUDIO_DRIVER_COREAUDIO
slouken@935
   153
extern AudioBootStrap COREAUDIO_bootstrap;
slouken@935
   154
#endif
slouken@1361
   155
#if SDL_AUDIO_DRIVER_SNDMGR
slouken@0
   156
extern AudioBootStrap SNDMGR_bootstrap;
slouken@0
   157
#endif
slouken@1361
   158
#if SDL_AUDIO_DRIVER_AHI
slouken@21
   159
extern AudioBootStrap AHI_bootstrap;
slouken@0
   160
#endif
slouken@1361
   161
#if SDL_AUDIO_DRIVER_MINT
patmandin@644
   162
extern AudioBootStrap MINTAUDIO_GSXB_bootstrap;
patmandin@644
   163
extern AudioBootStrap MINTAUDIO_MCSN_bootstrap;
patmandin@644
   164
extern AudioBootStrap MINTAUDIO_STFA_bootstrap;
patmandin@644
   165
extern AudioBootStrap MINTAUDIO_XBIOS_bootstrap;
patmandin@644
   166
extern AudioBootStrap MINTAUDIO_DMA8_bootstrap;
slouken@398
   167
#endif
slouken@1361
   168
#if SDL_AUDIO_DRIVER_DISK
slouken@68
   169
extern AudioBootStrap DISKAUD_bootstrap;
slouken@68
   170
#endif
icculus@1532
   171
#if SDL_AUDIO_DRIVER_DUMMY
icculus@1532
   172
extern AudioBootStrap DUMMYAUD_bootstrap;
icculus@1532
   173
#endif
slouken@1361
   174
#if SDL_AUDIO_DRIVER_DC
slouken@509
   175
extern AudioBootStrap DCAUD_bootstrap;
slouken@509
   176
#endif
slouken@1361
   177
#if SDL_AUDIO_DRIVER_MMEAUDIO
slouken@654
   178
extern AudioBootStrap MMEAUDIO_bootstrap;
slouken@654
   179
#endif
slouken@1361
   180
#if SDL_AUDIO_DRIVER_DART
icculus@1190
   181
extern AudioBootStrap DART_bootstrap;
icculus@1190
   182
#endif
slouken@0
   183
slouken@0
   184
#endif /* _SDL_sysaudio_h */
slouken@1895
   185
/* vi: set ts=4 sw=4 expandtab: */