]> git.sesse.net Git - vlc/blob - modules/audio_output/directx.c
DirectSound: Options change
[vlc] / modules / audio_output / directx.c
1 /*****************************************************************************
2  * directx.c: Windows DirectX audio output method
3  *****************************************************************************
4  * Copyright (C) 2001-2009 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Gildas Bazin <gbazin@videolan.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 /*****************************************************************************
25  * Preamble
26  *****************************************************************************/
27
28 #ifdef HAVE_CONFIG_H
29 # include "config.h"
30 #endif
31
32 #include <vlc_common.h>
33 #include <vlc_plugin.h>
34 #include <vlc_aout.h>
35 #include <vlc_charset.h>
36
37 #include "windows_audio_common.h"
38
39 #include <dsound.h>
40
41 #define FRAME_SIZE ((int)p_aout->output.output.i_rate/20) /* Size in samples */
42
43 /*****************************************************************************
44  * notification_thread_t: DirectX event thread
45  *****************************************************************************/
46 typedef struct notification_thread_t
47 {
48     VLC_COMMON_MEMBERS
49
50     aout_instance_t *p_aout;
51     int i_frame_size;                          /* size in bytes of one frame */
52     int i_write_slot;       /* current write position in our circular buffer */
53
54     mtime_t start_date;
55     HANDLE event;
56
57 } notification_thread_t;
58
59 /*****************************************************************************
60  * aout_sys_t: directx audio output method descriptor
61  *****************************************************************************
62  * This structure is part of the audio output thread descriptor.
63  * It describes the direct sound specific properties of an audio device.
64  *****************************************************************************/
65 struct aout_sys_t
66 {
67     HINSTANCE           hdsound_dll;      /* handle of the opened dsound dll */
68
69     char *              psz_device;              /* user defined device name */
70     LPGUID              p_device_guid;
71
72     LPDIRECTSOUND       p_dsobject;              /* main Direct Sound object */
73     LPDIRECTSOUNDBUFFER p_dsbuffer;   /* the sound buffer we use (direct sound
74                                        * takes care of mixing all the
75                                        * secondary buffers into the primary) */
76
77     notification_thread_t *p_notif;                  /* DirectSoundThread id */
78
79     int      b_playing;                                    /* playing status */
80
81     int      i_frame_size;                     /* Size in bytes of one frame */
82
83     int      i_speaker_setup;                      /* Speaker setup override */
84
85     bool     b_chan_reorder;                /* do we need channel reordering */
86     int      pi_chan_table[AOUT_CHAN_MAX];
87     uint32_t i_channel_mask;
88     uint32_t i_bits_per_sample;
89     uint32_t i_channels;
90 };
91
92 /*****************************************************************************
93  * Local prototypes.
94  *****************************************************************************/
95 static int  OpenAudio  ( vlc_object_t * );
96 static void CloseAudio ( vlc_object_t * );
97 static void Play       ( aout_instance_t * );
98
99 /* local functions */
100 static void Probe             ( aout_instance_t * );
101 static int  InitDirectSound   ( aout_instance_t * );
102 static int  CreateDSBuffer    ( aout_instance_t *, int, int, int, int, int, bool );
103 static int  CreateDSBufferPCM ( aout_instance_t *, vlc_fourcc_t*, int, int, int, bool );
104 static void DestroyDSBuffer   ( aout_instance_t * );
105 static void* DirectSoundThread( vlc_object_t * );
106 static int  FillBuffer        ( aout_instance_t *, int, aout_buffer_t * );
107
108 static int ReloadDirectXDevices( vlc_object_t *, char const *,
109                                 vlc_value_t, vlc_value_t, void * );
110
111 /* Speaker setup override options list */
112 static const char *const speaker_list[] = { "Windows default", "Mono", "Stereo",
113                                             "Quad", "5.1", "7.1" };
114 static const char *const ppsz_adev[] = {"default",  };
115 static const char *const ppsz_adev_text[] = {"default", };
116
117 /*****************************************************************************
118  * Module descriptor
119  *****************************************************************************/
120 #define DEVICE_TEXT N_("Output device")
121 #define DEVICE_LONGTEXT N_("Select your audio output device")
122
123 #define SPEAKER_TEXT N_("Speaker configuration")
124 #define SPEAKER_LONGTEXT N_("Select speaker configuration you want to use. " \
125     "This option doesn't upmix! So NO e.g. Stereo -> 5.1 conversion." )
126
127 vlc_module_begin ()
128     set_description( N_("DirectX audio output") )
129     set_shortname( "DirectX" )
130     set_capability( "audio output", 100 )
131     set_category( CAT_AUDIO )
132     set_subcategory( SUBCAT_AUDIO_AOUT )
133     add_shortcut( "directx" )
134     add_shortcut( "directsound" )
135
136     add_string( "directx-audio-device-name", "default", NULL,
137              DEVICE_TEXT, DEVICE_LONGTEXT, false )
138         add_deprecated_alias( "directx-audio-device" ) /* Since 1.1.0 */
139         change_string_list( ppsz_adev, ppsz_adev_text, ReloadDirectXDevices )
140         change_action_add( ReloadDirectXDevices, N_("Refresh list") )
141         change_need_restart ()
142     add_bool( "directx-audio-float32", false, NULL, FLOAT_TEXT,
143               FLOAT_LONGTEXT, true )
144     add_string( "directx-audio-speaker", "Windows default", NULL,
145                  SPEAKER_TEXT, SPEAKER_LONGTEXT, true )
146         change_string_list( speaker_list, 0, 0 )
147         change_need_restart ()
148
149     set_callbacks( OpenAudio, CloseAudio )
150 vlc_module_end ()
151
152 /*****************************************************************************
153  * OpenAudio: open the audio device
154  *****************************************************************************
155  * This function opens and setups Direct Sound.
156  *****************************************************************************/
157 static int OpenAudio( vlc_object_t *p_this )
158 {
159     aout_instance_t * p_aout = (aout_instance_t *)p_this;
160     vlc_value_t val;
161     char * psz_speaker;
162     int i = 0;
163
164     const char * const * ppsz_compare = speaker_list;
165
166     msg_Dbg( p_aout, "Opening DirectSound Audio Output" );
167
168    /* Allocate structure */
169     p_aout->output.p_sys = malloc( sizeof( aout_sys_t ) );
170     if( p_aout->output.p_sys == NULL )
171         return VLC_ENOMEM;
172
173     /* Initialize some variables */
174     p_aout->output.p_sys->p_dsobject = NULL;
175     p_aout->output.p_sys->p_dsbuffer = NULL;
176     p_aout->output.p_sys->p_notif = NULL;
177     p_aout->output.p_sys->b_playing = 0;
178
179     p_aout->output.pf_play = Play;
180     aout_VolumeSoftInit( p_aout );
181
182     /* Retrieve config values */
183     var_Create( p_aout, "directx-audio-float32",
184                 VLC_VAR_BOOL | VLC_VAR_DOINHERIT );
185     psz_speaker = var_CreateGetString( p_aout, "directx-audio-speaker" );
186
187     while ( *ppsz_compare != NULL )
188     {
189         if ( !strncmp( *ppsz_compare, psz_speaker, strlen(*ppsz_compare) ) )
190         {
191             break;
192         }
193         ppsz_compare++; i++;
194     }
195
196     if ( *ppsz_compare == NULL )
197     {
198         msg_Err( p_aout, "(%s) isn't valid speaker setup option", psz_speaker );
199         msg_Err( p_aout, "Defaulting to Windows default speaker config");
200         i = 0;
201     }
202     free( psz_speaker );
203     p_aout->output.p_sys->i_speaker_setup = i;
204
205     p_aout->output.p_sys->p_device_guid = 0;
206
207     /* Initialise DirectSound */
208     if( InitDirectSound( p_aout ) )
209     {
210         msg_Err( p_aout, "cannot initialize DirectSound" );
211         goto error;
212     }
213
214     if( var_Type( p_aout, "audio-device" ) == 0 )
215     {
216         Probe( p_aout );
217     }
218
219     if( var_Get( p_aout, "audio-device", &val ) < 0 )
220     {
221         /* Probe() has failed. */
222         goto error;
223     }
224
225     /* Open the device */
226     if( val.i_int == AOUT_VAR_SPDIF )
227     {
228         p_aout->output.output.i_format = VLC_CODEC_SPDIFL;
229
230         /* Calculate the frame size in bytes */
231         p_aout->output.i_nb_samples = A52_FRAME_NB;
232         p_aout->output.output.i_bytes_per_frame = AOUT_SPDIF_SIZE;
233         p_aout->output.output.i_frame_length = A52_FRAME_NB;
234         p_aout->output.p_sys->i_frame_size =
235             p_aout->output.output.i_bytes_per_frame;
236
237         if( CreateDSBuffer( p_aout, VLC_CODEC_SPDIFL,
238                             p_aout->output.output.i_physical_channels,
239                             aout_FormatNbChannels( &p_aout->output.output ),
240                             p_aout->output.output.i_rate,
241                             p_aout->output.p_sys->i_frame_size, false )
242             != VLC_SUCCESS )
243         {
244             msg_Err( p_aout, "cannot open directx audio device" );
245             free( p_aout->output.p_sys );
246             return VLC_EGENERIC;
247         }
248
249         aout_VolumeNoneInit( p_aout );
250     }
251     else
252     {
253         if( val.i_int == AOUT_VAR_5_1 )
254         {
255             p_aout->output.output.i_physical_channels
256                 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
257                    | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
258                    | AOUT_CHAN_LFE;
259         }
260         else if( val.i_int == AOUT_VAR_7_1 )
261         {
262                     p_aout->output.output.i_physical_channels
263                         = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
264                            | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
265                            | AOUT_CHAN_MIDDLELEFT | AOUT_CHAN_MIDDLERIGHT
266                            | AOUT_CHAN_LFE;
267         }
268         else if( val.i_int == AOUT_VAR_3F2R )
269         {
270             p_aout->output.output.i_physical_channels
271                 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
272                    | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT;
273         }
274         else if( val.i_int == AOUT_VAR_2F2R )
275         {
276             p_aout->output.output.i_physical_channels
277                 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT
278                    | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT;
279         }
280         else if( val.i_int == AOUT_VAR_MONO )
281         {
282             p_aout->output.output.i_physical_channels = AOUT_CHAN_CENTER;
283         }
284         else
285         {
286             p_aout->output.output.i_physical_channels
287                 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
288         }
289
290         if( CreateDSBufferPCM( p_aout, &p_aout->output.output.i_format,
291                                p_aout->output.output.i_physical_channels,
292                                aout_FormatNbChannels( &p_aout->output.output ),
293                                p_aout->output.output.i_rate, false )
294             != VLC_SUCCESS )
295         {
296             msg_Err( p_aout, "cannot open directx audio device" );
297             free( p_aout->output.p_sys );
298             return VLC_EGENERIC;
299         }
300
301         /* Calculate the frame size in bytes */
302         p_aout->output.i_nb_samples = FRAME_SIZE;
303         aout_FormatPrepare( &p_aout->output.output );
304         aout_VolumeSoftInit( p_aout );
305     }
306
307     /* Now we need to setup our DirectSound play notification structure */
308     p_aout->output.p_sys->p_notif =
309         vlc_object_create( p_aout, sizeof(notification_thread_t) );
310     p_aout->output.p_sys->p_notif->p_aout = p_aout;
311
312     p_aout->output.p_sys->p_notif->event = CreateEvent( 0, FALSE, FALSE, 0 );
313     p_aout->output.p_sys->p_notif->i_frame_size =
314         p_aout->output.p_sys->i_frame_size;
315
316     /* then launch the notification thread */
317     msg_Dbg( p_aout, "creating DirectSoundThread" );
318     if( vlc_thread_create( p_aout->output.p_sys->p_notif,
319                            "DirectSound Notification Thread",
320                            DirectSoundThread,
321                            VLC_THREAD_PRIORITY_HIGHEST ) )
322     {
323         msg_Err( p_aout, "cannot create DirectSoundThread" );
324         CloseHandle( p_aout->output.p_sys->p_notif->event );
325         vlc_object_release( p_aout->output.p_sys->p_notif );
326         p_aout->output.p_sys->p_notif = NULL;
327         goto error;
328     }
329
330     vlc_object_attach( p_aout->output.p_sys->p_notif, p_aout );
331
332     return VLC_SUCCESS;
333
334  error:
335     CloseAudio( VLC_OBJECT(p_aout) );
336     return VLC_EGENERIC;
337 }
338
339 /*****************************************************************************
340  * Probe: probe the audio device for available formats and channels
341  *****************************************************************************/
342 static void Probe( aout_instance_t * p_aout )
343 {
344     vlc_value_t val, text;
345     vlc_fourcc_t i_format;
346     unsigned int i_physical_channels;
347     DWORD ui_speaker_config;
348     bool is_default_output_set = false;
349
350     var_Create( p_aout, "audio-device", VLC_VAR_INTEGER | VLC_VAR_HASCHOICE );
351     text.psz_string = _("Audio Device");
352     var_Change( p_aout, "audio-device", VLC_VAR_SETTEXT, &text, NULL );
353
354     /* Test for 5.1 support */
355     i_physical_channels = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT |
356                           AOUT_CHAN_CENTER | AOUT_CHAN_REARLEFT |
357                           AOUT_CHAN_REARRIGHT | AOUT_CHAN_LFE;
358     if( p_aout->output.output.i_physical_channels == i_physical_channels )
359     {
360         if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 6,
361                                p_aout->output.output.i_rate, true )
362             == VLC_SUCCESS )
363         {
364             val.i_int = AOUT_VAR_5_1;
365             text.psz_string = (char*) "5.1";
366             var_Change( p_aout, "audio-device",
367                         VLC_VAR_ADDCHOICE, &val, &text );
368             var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT, &val, NULL );
369             is_default_output_set = true;
370             msg_Dbg( p_aout, "device supports 5.1 channels" );
371         }
372     }
373
374     /* Test for 7.1 support */
375     i_physical_channels = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT |
376                              AOUT_CHAN_CENTER | AOUT_CHAN_REARLEFT |
377                              AOUT_CHAN_MIDDLELEFT | AOUT_CHAN_MIDDLERIGHT |
378                              AOUT_CHAN_REARRIGHT | AOUT_CHAN_LFE;
379     if( p_aout->output.output.i_physical_channels == i_physical_channels )
380     {
381         if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 8,
382                                   p_aout->output.output.i_rate, true )
383             == VLC_SUCCESS )
384         {
385             val.i_int = AOUT_VAR_7_1;
386             text.psz_string = (char*) "7.1";
387             var_Change( p_aout, "audio-device",
388                         VLC_VAR_ADDCHOICE, &val, &text );
389             var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT, &val, NULL );
390             is_default_output_set = true;
391             msg_Dbg( p_aout, "device supports 7.1 channels" );
392         }
393     }
394
395     /* Test for 3 Front 2 Rear support */
396     i_physical_channels = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT |
397                           AOUT_CHAN_CENTER | AOUT_CHAN_REARLEFT |
398                           AOUT_CHAN_REARRIGHT;
399     if( p_aout->output.output.i_physical_channels == i_physical_channels )
400     {
401         if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 5,
402                                p_aout->output.output.i_rate, true )
403             == VLC_SUCCESS )
404         {
405             val.i_int = AOUT_VAR_3F2R;
406             text.psz_string = _("3 Front 2 Rear");
407             var_Change( p_aout, "audio-device",
408                         VLC_VAR_ADDCHOICE, &val, &text );
409             if(!is_default_output_set)
410             {
411                 var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT, &val, NULL );
412                 is_default_output_set = true;
413             }
414             msg_Dbg( p_aout, "device supports 5 channels" );
415         }
416     }
417
418     /* Test for 2 Front 2 Rear support */
419     i_physical_channels = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT |
420                           AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT;
421     if( ( p_aout->output.output.i_physical_channels & i_physical_channels )
422         == i_physical_channels )
423     {
424         if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 4,
425                                p_aout->output.output.i_rate, true )
426             == VLC_SUCCESS )
427         {
428             val.i_int = AOUT_VAR_2F2R;
429             text.psz_string = _("2 Front 2 Rear");
430             var_Change( p_aout, "audio-device",
431                         VLC_VAR_ADDCHOICE, &val, &text );
432             if(!is_default_output_set)
433             {
434                 var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT, &val, NULL );
435                 is_default_output_set = true;
436             }
437             msg_Dbg( p_aout, "device supports 4 channels" );
438         }
439     }
440
441     /* Test for stereo support */
442     i_physical_channels = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
443     if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 2,
444                            p_aout->output.output.i_rate, true )
445         == VLC_SUCCESS )
446     {
447         val.i_int = AOUT_VAR_STEREO;
448         text.psz_string = _("Stereo");
449         var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE, &val, &text );
450         if(!is_default_output_set)
451         {
452             var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT, &val, NULL );
453             is_default_output_set = true;
454             msg_Dbg( p_aout, "device supports 2 channels (DEFAULT!)" );
455         }
456         else msg_Dbg( p_aout, "device supports 2 channels" );
457     }
458
459     /* Test for mono support */
460     i_physical_channels = AOUT_CHAN_CENTER;
461     if( CreateDSBufferPCM( p_aout, &i_format, i_physical_channels, 1,
462                            p_aout->output.output.i_rate, true )
463         == VLC_SUCCESS )
464     {
465         val.i_int = AOUT_VAR_MONO;
466         text.psz_string = _("Mono");
467         var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE, &val, &text );
468         msg_Dbg( p_aout, "device supports 1 channel" );
469     }
470
471     /* Check the speaker configuration to determine which channel config should
472      * be the default */
473     if FAILED( IDirectSound_GetSpeakerConfig( p_aout->output.p_sys->p_dsobject,
474                                               &ui_speaker_config ) )
475     {
476         ui_speaker_config = DSSPEAKER_STEREO;
477         msg_Dbg( p_aout, "GetSpeakerConfig failed" );
478     }
479     switch( DSSPEAKER_CONFIG(ui_speaker_config) )
480     {
481     case DSSPEAKER_7POINT1:
482         msg_Dbg( p_aout, "Windows says your SpeakerConfig is 7.1" );
483         val.i_int = AOUT_VAR_7_1;
484         break;
485     case DSSPEAKER_5POINT1:
486         msg_Dbg( p_aout, "Windows says your SpeakerConfig is 5.1" );
487         val.i_int = AOUT_VAR_5_1;
488         break;
489     case DSSPEAKER_QUAD:
490         msg_Dbg( p_aout, "Windows says your SpeakerConfig is Quad" );
491         val.i_int = AOUT_VAR_2F2R;
492         break;
493 #if 0 /* Lots of people just get their settings wrong and complain that
494        * this is a problem with VLC so just don't ever set mono by default. */
495     case DSSPEAKER_MONO:
496         val.i_int = AOUT_VAR_MONO;
497         break;
498 #endif
499     case DSSPEAKER_SURROUND:
500         msg_Dbg( p_aout, "Windows says your SpeakerConfig is surround" );
501     case DSSPEAKER_STEREO:
502         msg_Dbg( p_aout, "Windows says your SpeakerConfig is stereo" );
503     default:
504         /* If nothing else is found, choose stereo output */
505         val.i_int = AOUT_VAR_STEREO;
506         break;
507     }
508
509     /* Check if we want to override speaker config */
510     switch( p_aout->output.p_sys->i_speaker_setup )
511     {
512     case 0: /* Default value aka Windows default speaker setup */
513         break;
514     case 1: /* Mono */
515         msg_Dbg( p_aout, "SpeakerConfig is forced to Mono" );
516         val.i_int = AOUT_VAR_MONO;
517         break;
518     case 2: /* Stereo */
519         msg_Dbg( p_aout, "SpeakerConfig is forced to Stereo" );
520         val.i_int = AOUT_VAR_STEREO;
521         break;
522     case 3: /* Quad */
523         msg_Dbg( p_aout, "SpeakerConfig is forced to Quad" );
524         val.i_int = AOUT_VAR_2F2R;
525         break;
526     case 4: /* 5.1 */
527         msg_Dbg( p_aout, "SpeakerConfig is forced to 5.1" );
528         val.i_int = AOUT_VAR_5_1;
529         break;
530     case 5: /* 7.1 */
531         msg_Dbg( p_aout, "SpeakerConfig is forced to 7.1" );
532         val.i_int = AOUT_VAR_7_1;
533         break;
534     default:
535         msg_Dbg( p_aout, "SpeakerConfig is forced to non-existing value" );
536         break;
537     }
538
539     var_Set( p_aout, "audio-device", val );
540
541     /* Test for SPDIF support */
542     if ( AOUT_FMT_NON_LINEAR( &p_aout->output.output ) )
543     {
544         if( CreateDSBuffer( p_aout, VLC_CODEC_SPDIFL,
545                             p_aout->output.output.i_physical_channels,
546                             aout_FormatNbChannels( &p_aout->output.output ),
547                             p_aout->output.output.i_rate,
548                             AOUT_SPDIF_SIZE, true )
549             == VLC_SUCCESS )
550         {
551             msg_Dbg( p_aout, "device supports A/52 over S/PDIF" );
552             val.i_int = AOUT_VAR_SPDIF;
553             text.psz_string = _("A/52 over S/PDIF");
554             var_Change( p_aout, "audio-device",
555                         VLC_VAR_ADDCHOICE, &val, &text );
556             if( config_GetInt( p_aout, "spdif" ) )
557                 var_Set( p_aout, "audio-device", val );
558         }
559     }
560
561     var_Change( p_aout, "audio-device", VLC_VAR_CHOICESCOUNT, &val, NULL );
562     if( val.i_int <= 0 )
563     {
564         /* Probe() has failed. */
565         var_Destroy( p_aout, "audio-device" );
566         return;
567     }
568
569     var_AddCallback( p_aout, "audio-device", aout_ChannelsRestart, NULL );
570     var_SetBool( p_aout, "intf-change", true );
571 }
572
573 /*****************************************************************************
574  * Play: we'll start playing the directsound buffer here because at least here
575  *       we know the first buffer has been put in the aout fifo and we also
576  *       know its date.
577  *****************************************************************************/
578 static void Play( aout_instance_t *p_aout )
579 {
580     if( !p_aout->output.p_sys->b_playing )
581     {
582         aout_buffer_t *p_buffer;
583         int i;
584
585         p_aout->output.p_sys->b_playing = 1;
586
587         /* get the playing date of the first aout buffer */
588         p_aout->output.p_sys->p_notif->start_date =
589             aout_FifoFirstDate( p_aout, &p_aout->output.fifo );
590
591         /* fill in the first samples */
592         for( i = 0; i < FRAMES_NUM; i++ )
593         {
594             p_buffer = aout_FifoPop( p_aout, &p_aout->output.fifo );
595             if( !p_buffer ) break;
596             FillBuffer( p_aout, i, p_buffer );
597         }
598
599         /* wake up the audio output thread */
600         SetEvent( p_aout->output.p_sys->p_notif->event );
601     }
602 }
603
604 /*****************************************************************************
605  * CloseAudio: close the audio device
606  *****************************************************************************/
607 static void CloseAudio( vlc_object_t *p_this )
608 {
609     aout_instance_t * p_aout = (aout_instance_t *)p_this;
610     aout_sys_t *p_sys = p_aout->output.p_sys;
611
612     msg_Dbg( p_aout, "closing audio device" );
613
614     /* kill the position notification thread, if any */
615     if( p_sys->p_notif )
616     {
617         vlc_object_detach( p_sys->p_notif );
618         vlc_object_kill( p_sys->p_notif );
619         /* wake up the audio thread if needed */
620         if( !p_sys->b_playing ) SetEvent( p_sys->p_notif->event );
621
622         vlc_thread_join( p_sys->p_notif );
623         vlc_object_release( p_sys->p_notif );
624     }
625
626     /* release the secondary buffer */
627     DestroyDSBuffer( p_aout );
628
629     /* finally release the DirectSound object */
630     if( p_sys->p_dsobject ) IDirectSound_Release( p_sys->p_dsobject );
631
632     /* free DSOUND.DLL */
633     if( p_sys->hdsound_dll ) FreeLibrary( p_sys->hdsound_dll );
634
635     free( p_aout->output.p_sys->p_device_guid );
636     free( p_sys );
637 }
638
639 /*****************************************************************************
640  * CallBackDirectSoundEnum: callback to enumerate available devices
641  *****************************************************************************/
642 static int CALLBACK CallBackDirectSoundEnum( LPGUID p_guid, LPCSTR psz_desc,
643                                              LPCSTR psz_mod, LPVOID _p_aout )
644 {
645     VLC_UNUSED( psz_mod );
646
647     aout_instance_t *p_aout = (aout_instance_t *)_p_aout;
648
649     msg_Dbg( p_aout, "found device: %s", psz_desc );
650
651     if( p_aout->output.p_sys->psz_device && !strcmp(p_aout->output.p_sys->psz_device, psz_desc) && p_guid )
652     {
653         /* Use the device corresponding to psz_device */
654         p_aout->output.p_sys->p_device_guid = malloc( sizeof( GUID ) );
655         *p_aout->output.p_sys->p_device_guid = *p_guid;
656         msg_Dbg( p_aout, "using device: %s", psz_desc );
657     }
658     else
659     {
660         /* If no default device has been selected, chose the first one */
661         if( !p_aout->output.p_sys->psz_device && p_guid )
662         {
663             p_aout->output.p_sys->psz_device = strdup( psz_desc );
664             p_aout->output.p_sys->p_device_guid = malloc( sizeof( GUID ) );
665             *p_aout->output.p_sys->p_device_guid = *p_guid;
666             msg_Dbg( p_aout, "using device: %s", psz_desc );
667         }
668     }
669     return 1;
670 }
671
672 /*****************************************************************************
673  * InitDirectSound: handle all the gory details of DirectSound initialisation
674  *****************************************************************************/
675 static int InitDirectSound( aout_instance_t *p_aout )
676 {
677     HRESULT (WINAPI *OurDirectSoundCreate)(LPGUID, LPDIRECTSOUND *, LPUNKNOWN);
678     HRESULT (WINAPI *OurDirectSoundEnumerate)(LPDSENUMCALLBACK, LPVOID);
679
680     p_aout->output.p_sys->hdsound_dll = LoadLibrary("DSOUND.DLL");
681     if( p_aout->output.p_sys->hdsound_dll == NULL )
682     {
683         msg_Warn( p_aout, "cannot open DSOUND.DLL" );
684         goto error;
685     }
686
687     OurDirectSoundCreate = (void *)
688         GetProcAddress( p_aout->output.p_sys->hdsound_dll,
689                         "DirectSoundCreate" );
690     if( OurDirectSoundCreate == NULL )
691     {
692         msg_Warn( p_aout, "GetProcAddress FAILED" );
693         goto error;
694     }
695
696     /* Get DirectSoundEnumerate */
697     OurDirectSoundEnumerate = (void *)
698        GetProcAddress( p_aout->output.p_sys->hdsound_dll,
699                        "DirectSoundEnumerateW" );
700     if( OurDirectSoundEnumerate )
701     {
702         p_aout->output.p_sys->psz_device = config_GetPsz(p_aout, "directx-audio-device-name");
703         /* Attempt enumeration */
704         if( FAILED( OurDirectSoundEnumerate( CallBackDirectSoundEnum,
705                                              p_aout ) ) )
706         {
707             msg_Dbg( p_aout, "enumeration of DirectSound devices failed" );
708         }
709     }
710
711     /* Create the direct sound object */
712     if FAILED( OurDirectSoundCreate( p_aout->output.p_sys->p_device_guid,
713                                      &p_aout->output.p_sys->p_dsobject,
714                                      NULL ) )
715     {
716         msg_Warn( p_aout, "cannot create a direct sound device" );
717         goto error;
718     }
719
720     /* Set DirectSound Cooperative level, ie what control we want over Windows
721      * sound device. In our case, DSSCL_EXCLUSIVE means that we can modify the
722      * settings of the primary buffer, but also that only the sound of our
723      * application will be hearable when it will have the focus.
724      * !!! (this is not really working as intended yet because to set the
725      * cooperative level you need the window handle of your application, and
726      * I don't know of any easy way to get it. Especially since we might play
727      * sound without any video, and so what window handle should we use ???
728      * The hack for now is to use the Desktop window handle - it seems to be
729      * working */
730     if( IDirectSound_SetCooperativeLevel( p_aout->output.p_sys->p_dsobject,
731                                           GetDesktopWindow(),
732                                           DSSCL_EXCLUSIVE) )
733     {
734         msg_Warn( p_aout, "cannot set direct sound cooperative level" );
735     }
736
737     return VLC_SUCCESS;
738
739  error:
740     p_aout->output.p_sys->p_dsobject = NULL;
741     if( p_aout->output.p_sys->hdsound_dll )
742     {
743         FreeLibrary( p_aout->output.p_sys->hdsound_dll );
744         p_aout->output.p_sys->hdsound_dll = NULL;
745     }
746     return VLC_EGENERIC;
747
748 }
749
750 /*****************************************************************************
751  * CreateDSBuffer: Creates a direct sound buffer of the required format.
752  *****************************************************************************
753  * This function creates the buffer we'll use to play audio.
754  * In DirectSound there are two kinds of buffers:
755  * - the primary buffer: which is the actual buffer that the soundcard plays
756  * - the secondary buffer(s): these buffers are the one actually used by
757  *    applications and DirectSound takes care of mixing them into the primary.
758  *
759  * Once you create a secondary buffer, you cannot change its format anymore so
760  * you have to release the current one and create another.
761  *****************************************************************************/
762 static int CreateDSBuffer( aout_instance_t *p_aout, int i_format,
763                            int i_channels, int i_nb_channels, int i_rate,
764                            int i_bytes_per_frame, bool b_probe )
765 {
766     WAVEFORMATEXTENSIBLE waveformat;
767     DSBUFFERDESC         dsbdesc;
768     unsigned int         i;
769
770     /* First set the sound buffer format */
771     waveformat.dwChannelMask = 0;
772     for( i = 0; i < sizeof(pi_channels_src)/sizeof(uint32_t); i++ )
773     {
774         if( i_channels & pi_channels_src[i] )
775             waveformat.dwChannelMask |= pi_channels_in[i];
776     }
777
778     switch( i_format )
779     {
780     case VLC_CODEC_SPDIFL:
781         i_nb_channels = 2;
782         /* To prevent channel re-ordering */
783         waveformat.dwChannelMask = SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT;
784         waveformat.Format.wBitsPerSample = 16;
785         waveformat.Samples.wValidBitsPerSample =
786             waveformat.Format.wBitsPerSample;
787         waveformat.Format.wFormatTag = WAVE_FORMAT_DOLBY_AC3_SPDIF;
788         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_DOLBY_AC3_SPDIF;
789         break;
790
791     case VLC_CODEC_FL32:
792         waveformat.Format.wBitsPerSample = sizeof(float) * 8;
793         waveformat.Samples.wValidBitsPerSample =
794             waveformat.Format.wBitsPerSample;
795         waveformat.Format.wFormatTag = WAVE_FORMAT_IEEE_FLOAT;
796         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_IEEE_FLOAT;
797         break;
798
799     case VLC_CODEC_S16L:
800         waveformat.Format.wBitsPerSample = 16;
801         waveformat.Samples.wValidBitsPerSample =
802             waveformat.Format.wBitsPerSample;
803         waveformat.Format.wFormatTag = WAVE_FORMAT_PCM;
804         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_PCM;
805         break;
806     }
807
808     waveformat.Format.nChannels = i_nb_channels;
809     waveformat.Format.nSamplesPerSec = i_rate;
810     waveformat.Format.nBlockAlign =
811         waveformat.Format.wBitsPerSample / 8 * i_nb_channels;
812     waveformat.Format.nAvgBytesPerSec =
813         waveformat.Format.nSamplesPerSec * waveformat.Format.nBlockAlign;
814
815     p_aout->output.p_sys->i_bits_per_sample = waveformat.Format.wBitsPerSample;
816     p_aout->output.p_sys->i_channels = i_nb_channels;
817
818     /* Then fill in the direct sound descriptor */
819     memset(&dsbdesc, 0, sizeof(DSBUFFERDESC));
820     dsbdesc.dwSize = sizeof(DSBUFFERDESC);
821     dsbdesc.dwFlags = DSBCAPS_GETCURRENTPOSITION2/* Better position accuracy */
822                     | DSBCAPS_GLOBALFOCUS;      /* Allows background playing */
823
824     /* Only use the new WAVE_FORMAT_EXTENSIBLE format for multichannel audio */
825     if( i_nb_channels <= 2 )
826     {
827         waveformat.Format.cbSize = 0;
828     }
829     else
830     {
831         waveformat.Format.wFormatTag = WAVE_FORMAT_EXTENSIBLE;
832         waveformat.Format.cbSize =
833             sizeof(WAVEFORMATEXTENSIBLE) - sizeof(WAVEFORMATEX);
834
835         /* Needed for 5.1 on emu101k */
836         dsbdesc.dwFlags |= DSBCAPS_LOCHARDWARE;
837     }
838
839     dsbdesc.dwBufferBytes = FRAMES_NUM * i_bytes_per_frame;   /* buffer size */
840     dsbdesc.lpwfxFormat = (WAVEFORMATEX *)&waveformat;
841
842     if FAILED( IDirectSound_CreateSoundBuffer(
843                    p_aout->output.p_sys->p_dsobject, &dsbdesc,
844                    &p_aout->output.p_sys->p_dsbuffer, NULL) )
845     {
846         if( dsbdesc.dwFlags & DSBCAPS_LOCHARDWARE )
847         {
848             /* Try without DSBCAPS_LOCHARDWARE */
849             dsbdesc.dwFlags &= ~DSBCAPS_LOCHARDWARE;
850             if FAILED( IDirectSound_CreateSoundBuffer(
851                    p_aout->output.p_sys->p_dsobject, &dsbdesc,
852                    &p_aout->output.p_sys->p_dsbuffer, NULL) )
853             {
854                 return VLC_EGENERIC;
855             }
856             if( !b_probe )
857                 msg_Dbg( p_aout, "couldn't use hardware sound buffer" );
858         }
859         else
860         {
861             return VLC_EGENERIC;
862         }
863     }
864
865     /* Stop here if we were just probing */
866     if( b_probe )
867     {
868         IDirectSoundBuffer_Release( p_aout->output.p_sys->p_dsbuffer );
869         p_aout->output.p_sys->p_dsbuffer = NULL;
870         return VLC_SUCCESS;
871     }
872
873     p_aout->output.p_sys->i_frame_size = i_bytes_per_frame;
874     p_aout->output.p_sys->i_channel_mask = waveformat.dwChannelMask;
875     p_aout->output.p_sys->b_chan_reorder =
876         aout_CheckChannelReorder( pi_channels_in, pi_channels_out,
877                                   waveformat.dwChannelMask, i_nb_channels,
878                                   p_aout->output.p_sys->pi_chan_table );
879
880     if( p_aout->output.p_sys->b_chan_reorder )
881     {
882         msg_Dbg( p_aout, "channel reordering needed" );
883     }
884
885     return VLC_SUCCESS;
886 }
887
888 /*****************************************************************************
889  * CreateDSBufferPCM: creates a PCM direct sound buffer.
890  *****************************************************************************
891  * We first try to create a WAVE_FORMAT_IEEE_FLOAT buffer if supported by
892  * the hardware, otherwise we create a WAVE_FORMAT_PCM buffer.
893  ****************************************************************************/
894 static int CreateDSBufferPCM( aout_instance_t *p_aout, vlc_fourcc_t *i_format,
895                               int i_channels, int i_nb_channels, int i_rate,
896                               bool b_probe )
897 {
898     /* Float32 audio samples are not supported for 5.1 output on the emu101k */
899     if( !var_GetBool( p_aout, "directx-audio-float32" ) ||
900         i_nb_channels > 2 ||
901         CreateDSBuffer( p_aout, VLC_CODEC_FL32,
902                         i_channels, i_nb_channels, i_rate,
903                         FRAME_SIZE * 4 * i_nb_channels, b_probe )
904         != VLC_SUCCESS )
905     {
906         if ( CreateDSBuffer( p_aout, VLC_CODEC_S16L,
907                              i_channels, i_nb_channels, i_rate,
908                              FRAME_SIZE * 2 * i_nb_channels, b_probe )
909              != VLC_SUCCESS )
910         {
911             return VLC_EGENERIC;
912         }
913         else
914         {
915             *i_format = VLC_CODEC_S16L;
916             return VLC_SUCCESS;
917         }
918     }
919     else
920     {
921         *i_format = VLC_CODEC_FL32;
922         return VLC_SUCCESS;
923     }
924 }
925
926 /*****************************************************************************
927  * DestroyDSBuffer
928  *****************************************************************************
929  * This function destroys the secondary buffer.
930  *****************************************************************************/
931 static void DestroyDSBuffer( aout_instance_t *p_aout )
932 {
933     if( p_aout->output.p_sys->p_dsbuffer )
934     {
935         IDirectSoundBuffer_Release( p_aout->output.p_sys->p_dsbuffer );
936         p_aout->output.p_sys->p_dsbuffer = NULL;
937     }
938 }
939
940 /*****************************************************************************
941  * FillBuffer: Fill in one of the direct sound frame buffers.
942  *****************************************************************************
943  * Returns VLC_SUCCESS on success.
944  *****************************************************************************/
945 static int FillBuffer( aout_instance_t *p_aout, int i_frame,
946                        aout_buffer_t *p_buffer )
947 {
948     notification_thread_t *p_notif = p_aout->output.p_sys->p_notif;
949     aout_sys_t *p_sys = p_aout->output.p_sys;
950     void *p_write_position, *p_wrap_around;
951     unsigned long l_bytes1, l_bytes2;
952     HRESULT dsresult;
953
954     /* Before copying anything, we have to lock the buffer */
955     dsresult = IDirectSoundBuffer_Lock(
956                 p_sys->p_dsbuffer,                              /* DS buffer */
957                 i_frame * p_notif->i_frame_size,             /* Start offset */
958                 p_notif->i_frame_size,                    /* Number of bytes */
959                 &p_write_position,                  /* Address of lock start */
960                 &l_bytes1,       /* Count of bytes locked before wrap around */
961                 &p_wrap_around,            /* Buffer adress (if wrap around) */
962                 &l_bytes2,               /* Count of bytes after wrap around */
963                 0 );                                                /* Flags */
964     if( dsresult == DSERR_BUFFERLOST )
965     {
966         IDirectSoundBuffer_Restore( p_sys->p_dsbuffer );
967         dsresult = IDirectSoundBuffer_Lock(
968                                p_sys->p_dsbuffer,
969                                i_frame * p_notif->i_frame_size,
970                                p_notif->i_frame_size,
971                                &p_write_position,
972                                &l_bytes1,
973                                &p_wrap_around,
974                                &l_bytes2,
975                                0 );
976     }
977     if( dsresult != DS_OK )
978     {
979         msg_Warn( p_notif, "cannot lock buffer" );
980         if( p_buffer ) aout_BufferFree( p_buffer );
981         return VLC_EGENERIC;
982     }
983
984     if( p_buffer == NULL )
985     {
986         memset( p_write_position, 0, l_bytes1 );
987     }
988     else
989     {
990         if( p_sys->b_chan_reorder )
991         {
992             /* Do the channel reordering here */
993             aout_ChannelReorder( p_buffer->p_buffer, p_buffer->i_buffer,
994                                  p_sys->i_channels, p_sys->pi_chan_table,
995                                  p_sys->i_bits_per_sample );
996         }
997
998         vlc_memcpy( p_write_position, p_buffer->p_buffer, l_bytes1 );
999         aout_BufferFree( p_buffer );
1000     }
1001
1002     /* Now the data has been copied, unlock the buffer */
1003     IDirectSoundBuffer_Unlock( p_sys->p_dsbuffer, p_write_position, l_bytes1,
1004                                p_wrap_around, l_bytes2 );
1005
1006     p_notif->i_write_slot = (i_frame + 1) % FRAMES_NUM;
1007     return VLC_SUCCESS;
1008 }
1009
1010 /*****************************************************************************
1011  * DirectSoundThread: this thread will capture play notification events.
1012  *****************************************************************************
1013  * We use this thread to emulate a callback mechanism. The thread probes for
1014  * event notification and fills up the DS secondary buffer when needed.
1015  *****************************************************************************/
1016 static void* DirectSoundThread( vlc_object_t *p_this )
1017 {
1018     notification_thread_t *p_notif = (notification_thread_t*)p_this;
1019     aout_instance_t *p_aout = p_notif->p_aout;
1020     mtime_t last_time;
1021     int canc = vlc_savecancel ();
1022
1023     /* We don't want any resampling when using S/PDIF output */
1024     bool b_sleek = (p_aout->output.output.i_format == VLC_CODEC_SPDIFL);
1025
1026     msg_Dbg( p_notif, "DirectSoundThread ready" );
1027
1028     /* Wait here until Play() is called */
1029     WaitForSingleObject( p_notif->event, INFINITE );
1030
1031     if( vlc_object_alive (p_notif) )
1032     {
1033         HRESULT dsresult;
1034         mwait( p_notif->start_date - AOUT_PTS_TOLERANCE / 2 );
1035
1036         /* start playing the buffer */
1037         dsresult = IDirectSoundBuffer_Play( p_aout->output.p_sys->p_dsbuffer,
1038                                         0,                         /* Unused */
1039                                         0,                         /* Unused */
1040                                         DSBPLAY_LOOPING );          /* Flags */
1041         if( dsresult == DSERR_BUFFERLOST )
1042         {
1043             IDirectSoundBuffer_Restore( p_aout->output.p_sys->p_dsbuffer );
1044             dsresult = IDirectSoundBuffer_Play(
1045                                             p_aout->output.p_sys->p_dsbuffer,
1046                                             0,                     /* Unused */
1047                                             0,                     /* Unused */
1048                                             DSBPLAY_LOOPING );      /* Flags */
1049         }
1050         if( dsresult != DS_OK )
1051         {
1052             msg_Err( p_aout, "cannot start playing buffer" );
1053         }
1054     }
1055     last_time = mdate();
1056
1057     while( vlc_object_alive (p_notif) )
1058     {
1059         DWORD l_read;
1060         int l_queued = 0, l_free_slots;
1061         unsigned i_frame_siz = p_aout->output.i_nb_samples;
1062         mtime_t mtime = mdate();
1063         int i;
1064
1065         /*
1066          * Fill in as much audio data as we can in our circular buffer
1067          */
1068
1069         /* Find out current play position */
1070         if FAILED( IDirectSoundBuffer_GetCurrentPosition(
1071                    p_aout->output.p_sys->p_dsbuffer, &l_read, NULL ) )
1072         {
1073             msg_Err( p_aout, "GetCurrentPosition() failed!" );
1074             l_read = 0;
1075         }
1076
1077         /* Detect underruns */
1078         if( l_queued && mtime - last_time >
1079             INT64_C(1000000) * l_queued / p_aout->output.output.i_rate )
1080         {
1081             msg_Dbg( p_aout, "detected underrun!" );
1082         }
1083         last_time = mtime;
1084
1085         /* Try to fill in as many frame buffers as possible */
1086         l_read /= (p_aout->output.output.i_bytes_per_frame /
1087             p_aout->output.output.i_frame_length);
1088         l_queued = p_notif->i_write_slot * i_frame_siz - l_read;
1089         if( l_queued < 0 ) l_queued += (i_frame_siz * FRAMES_NUM);
1090         l_free_slots = (FRAMES_NUM * i_frame_siz - l_queued) / i_frame_siz;
1091
1092         for( i = 0; i < l_free_slots; i++ )
1093         {
1094             aout_buffer_t *p_buffer = aout_OutputNextBuffer( p_aout,
1095                 mtime + INT64_C(1000000) * (i * i_frame_siz + l_queued) /
1096                 p_aout->output.output.i_rate, b_sleek );
1097
1098             /* If there is no audio data available and we have some buffered
1099              * already, then just wait for the next time */
1100             if( !p_buffer && (i || l_queued / i_frame_siz) ) break;
1101
1102             if( FillBuffer( p_aout, p_notif->i_write_slot % FRAMES_NUM,
1103                             p_buffer ) != VLC_SUCCESS ) break;
1104         }
1105
1106         /* Sleep a reasonable amount of time */
1107         l_queued += (i * i_frame_siz);
1108         msleep( INT64_C(1000000) * l_queued / p_aout->output.output.i_rate / 2 );
1109     }
1110
1111     /* make sure the buffer isn't playing */
1112     IDirectSoundBuffer_Stop( p_aout->output.p_sys->p_dsbuffer );
1113
1114     /* free the event */
1115     CloseHandle( p_notif->event );
1116
1117     vlc_restorecancel (canc);
1118     msg_Dbg( p_notif, "DirectSoundThread exiting" );
1119     return NULL;
1120 }
1121
1122 /*****************************************************************************
1123  * CallBackConfigNBEnum: callback to get the number of available devices
1124  *****************************************************************************/
1125 static int CALLBACK CallBackConfigNBEnum( LPGUID p_guid, LPCSTR psz_desc,
1126                                              LPCSTR psz_mod, LPVOID p_nb )
1127 {
1128     VLC_UNUSED( psz_mod ); VLC_UNUSED( psz_desc ); VLC_UNUSED( p_guid );
1129
1130     int * a = (int *)p_nb;
1131     (*a)++;
1132     return 1;
1133 }
1134
1135 /*****************************************************************************
1136  * CallBackConfigEnum: callback to add available devices to the preferences list
1137  *****************************************************************************/
1138 static int CALLBACK CallBackConfigEnum( LPGUID p_guid, LPCSTR psz_desc,
1139                                              LPCSTR psz_mod, LPVOID _p_item )
1140 {
1141     VLC_UNUSED( psz_mod );
1142     VLC_UNUSED( p_guid );
1143
1144     module_config_t *p_item = (module_config_t *) _p_item;
1145
1146     p_item->ppsz_list[p_item->i_list] = FromLocaleDup(psz_desc);
1147     p_item->ppsz_list_text[p_item->i_list] = FromLocaleDup(psz_desc);
1148     p_item->i_list = p_item->i_list +1;
1149     return 1;
1150 }
1151
1152 /*****************************************************************************
1153  * ReloadDirectXDevices: store the list of devices in preferences
1154  *****************************************************************************/
1155 static int ReloadDirectXDevices( vlc_object_t *p_this, char const *psz_name,
1156                                  vlc_value_t newval, vlc_value_t oldval, void *data )
1157 {
1158     VLC_UNUSED( newval ); VLC_UNUSED( oldval ); VLC_UNUSED( data );
1159     module_config_t *p_item = config_FindConfig( p_this, psz_name );
1160     if( !p_item ) return VLC_SUCCESS;
1161
1162     /* Clear-up the current list */
1163     if( p_item->i_list )
1164     {
1165         int i;
1166         for( i = 0; i < p_item->i_list; i++ )
1167         {
1168             free((char *)(p_item->ppsz_list[i]) );
1169             free((char *)(p_item->ppsz_list_text[i]) );
1170         }
1171     }
1172
1173     HRESULT (WINAPI *OurDirectSoundEnumerate)(LPDSENUMCALLBACK, LPVOID);
1174
1175     HANDLE hdsound_dll = LoadLibrary("DSOUND.DLL");
1176     if( hdsound_dll == NULL )
1177     {
1178         msg_Warn( p_this, "cannot open DSOUND.DLL" );
1179     }
1180
1181     /* Get DirectSoundEnumerate */
1182     OurDirectSoundEnumerate = (void *)
1183        GetProcAddress( hdsound_dll,
1184                        "DirectSoundEnumerateW" );
1185     int nb_devices = 0;
1186     OurDirectSoundEnumerate(CallBackConfigNBEnum, &nb_devices);
1187     msg_Dbg(p_this,"found %d devices", nb_devices);
1188
1189     p_item->ppsz_list = xrealloc( p_item->ppsz_list,
1190                           nb_devices * sizeof(char *) );
1191     p_item->ppsz_list_text = xrealloc( p_item->ppsz_list_text,
1192                           nb_devices * sizeof(char *) );
1193
1194     p_item->i_list = 0;
1195     OurDirectSoundEnumerate(CallBackConfigEnum, p_item);
1196
1197     FreeLibrary(hdsound_dll);
1198
1199     /* Signal change to the interface */
1200     p_item->b_dirty = true;
1201
1202     return VLC_SUCCESS;
1203 }
1204