]> git.sesse.net Git - vlc/blob - modules/audio_output/directx.c
f7e6895d313cfdf6c16aff0468f6a9196bfdf178
[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 Foundation, Inc.,
21  * 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( var_InheritInteger( 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
584         p_aout->output.p_sys->b_playing = 1;
585
586         /* get the playing date of the first aout buffer */
587         p_aout->output.p_sys->p_notif->start_date =
588             aout_FifoFirstDate( p_aout, &p_aout->output.fifo );
589
590         /* fill in the first samples */
591         for( int i = 0; i < FRAMES_NUM; i++ )
592         {
593             p_buffer = aout_FifoPop( p_aout, &p_aout->output.fifo );
594             if( !p_buffer ) break;
595             FillBuffer( p_aout, i, p_buffer );
596         }
597
598         /* wake up the audio output thread */
599         SetEvent( p_aout->output.p_sys->p_notif->event );
600     }
601 }
602
603 /*****************************************************************************
604  * CloseAudio: close the audio device
605  *****************************************************************************/
606 static void CloseAudio( vlc_object_t *p_this )
607 {
608     aout_instance_t * p_aout = (aout_instance_t *)p_this;
609     aout_sys_t *p_sys = p_aout->output.p_sys;
610
611     msg_Dbg( p_aout, "closing audio device" );
612
613     /* kill the position notification thread, if any */
614     if( p_sys->p_notif )
615     {
616         vlc_object_kill( p_sys->p_notif );
617         /* wake up the audio thread if needed */
618         if( !p_sys->b_playing ) SetEvent( p_sys->p_notif->event );
619
620         vlc_thread_join( p_sys->p_notif );
621         vlc_object_release( p_sys->p_notif );
622     }
623
624     /* release the secondary buffer */
625     DestroyDSBuffer( p_aout );
626
627     /* finally release the DirectSound object */
628     if( p_sys->p_dsobject ) IDirectSound_Release( p_sys->p_dsobject );
629
630     /* free DSOUND.DLL */
631     if( p_sys->hdsound_dll ) FreeLibrary( p_sys->hdsound_dll );
632
633     free( p_aout->output.p_sys->p_device_guid );
634     free( p_sys );
635 }
636
637 /*****************************************************************************
638  * CallBackDirectSoundEnum: callback to enumerate available devices
639  *****************************************************************************/
640 static int CALLBACK CallBackDirectSoundEnum( LPGUID p_guid, LPCWSTR psz_desc,
641                                              LPCWSTR psz_mod, LPVOID _p_aout )
642 {
643     VLC_UNUSED( psz_mod );
644
645     aout_instance_t *p_aout = (aout_instance_t *)_p_aout;
646
647     char *psz_device = FromWide( psz_desc );
648     msg_Dbg( p_aout, "found device: %s", psz_device );
649
650     if( p_aout->output.p_sys->psz_device &&
651         !strcmp(p_aout->output.p_sys->psz_device, psz_device) && 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_device );
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_device );
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_device );
667         }
668     }
669
670     free( psz_device );
671     return true;
672 }
673
674 /*****************************************************************************
675  * InitDirectSound: handle all the gory details of DirectSound initialisation
676  *****************************************************************************/
677 static int InitDirectSound( aout_instance_t *p_aout )
678 {
679     HRESULT (WINAPI *OurDirectSoundCreate)(LPGUID, LPDIRECTSOUND *, LPUNKNOWN);
680     HRESULT (WINAPI *OurDirectSoundEnumerate)(LPDSENUMCALLBACKW, LPVOID);
681
682     p_aout->output.p_sys->hdsound_dll = LoadLibrary("DSOUND.DLL");
683     if( p_aout->output.p_sys->hdsound_dll == NULL )
684     {
685         msg_Warn( p_aout, "cannot open DSOUND.DLL" );
686         goto error;
687     }
688
689     OurDirectSoundCreate = (void *)
690         GetProcAddress( p_aout->output.p_sys->hdsound_dll,
691                         "DirectSoundCreate" );
692     if( OurDirectSoundCreate == NULL )
693     {
694         msg_Warn( p_aout, "GetProcAddress FAILED" );
695         goto error;
696     }
697
698     /* Get DirectSoundEnumerate */
699     OurDirectSoundEnumerate = (void *)
700        GetProcAddress( p_aout->output.p_sys->hdsound_dll,
701                        "DirectSoundEnumerateW" );
702     if( OurDirectSoundEnumerate )
703     {
704         p_aout->output.p_sys->psz_device = var_InheritString(p_aout, "directx-audio-device-name");
705         /* Attempt enumeration */
706         if( FAILED( OurDirectSoundEnumerate( CallBackDirectSoundEnum,
707                                              p_aout ) ) )
708         {
709             msg_Dbg( p_aout, "enumeration of DirectSound devices failed" );
710         }
711     }
712
713     /* Create the direct sound object */
714     if FAILED( OurDirectSoundCreate( p_aout->output.p_sys->p_device_guid,
715                                      &p_aout->output.p_sys->p_dsobject,
716                                      NULL ) )
717     {
718         msg_Warn( p_aout, "cannot create a direct sound device" );
719         goto error;
720     }
721
722     /* Set DirectSound Cooperative level, ie what control we want over Windows
723      * sound device. In our case, DSSCL_EXCLUSIVE means that we can modify the
724      * settings of the primary buffer, but also that only the sound of our
725      * application will be hearable when it will have the focus.
726      * !!! (this is not really working as intended yet because to set the
727      * cooperative level you need the window handle of your application, and
728      * I don't know of any easy way to get it. Especially since we might play
729      * sound without any video, and so what window handle should we use ???
730      * The hack for now is to use the Desktop window handle - it seems to be
731      * working */
732     if( IDirectSound_SetCooperativeLevel( p_aout->output.p_sys->p_dsobject,
733                                           GetDesktopWindow(),
734                                           DSSCL_EXCLUSIVE) )
735     {
736         msg_Warn( p_aout, "cannot set direct sound cooperative level" );
737     }
738
739     return VLC_SUCCESS;
740
741  error:
742     p_aout->output.p_sys->p_dsobject = NULL;
743     if( p_aout->output.p_sys->hdsound_dll )
744     {
745         FreeLibrary( p_aout->output.p_sys->hdsound_dll );
746         p_aout->output.p_sys->hdsound_dll = NULL;
747     }
748     return VLC_EGENERIC;
749
750 }
751
752 /*****************************************************************************
753  * CreateDSBuffer: Creates a direct sound buffer of the required format.
754  *****************************************************************************
755  * This function creates the buffer we'll use to play audio.
756  * In DirectSound there are two kinds of buffers:
757  * - the primary buffer: which is the actual buffer that the soundcard plays
758  * - the secondary buffer(s): these buffers are the one actually used by
759  *    applications and DirectSound takes care of mixing them into the primary.
760  *
761  * Once you create a secondary buffer, you cannot change its format anymore so
762  * you have to release the current one and create another.
763  *****************************************************************************/
764 static int CreateDSBuffer( aout_instance_t *p_aout, int i_format,
765                            int i_channels, int i_nb_channels, int i_rate,
766                            int i_bytes_per_frame, bool b_probe )
767 {
768     WAVEFORMATEXTENSIBLE waveformat;
769     DSBUFFERDESC         dsbdesc;
770     unsigned int         i;
771
772     /* First set the sound buffer format */
773     waveformat.dwChannelMask = 0;
774     for( i = 0; i < sizeof(pi_channels_src)/sizeof(uint32_t); i++ )
775     {
776         if( i_channels & pi_channels_src[i] )
777             waveformat.dwChannelMask |= pi_channels_in[i];
778     }
779
780     switch( i_format )
781     {
782     case VLC_CODEC_SPDIFL:
783         i_nb_channels = 2;
784         /* To prevent channel re-ordering */
785         waveformat.dwChannelMask = SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT;
786         waveformat.Format.wBitsPerSample = 16;
787         waveformat.Samples.wValidBitsPerSample =
788             waveformat.Format.wBitsPerSample;
789         waveformat.Format.wFormatTag = WAVE_FORMAT_DOLBY_AC3_SPDIF;
790         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_DOLBY_AC3_SPDIF;
791         break;
792
793     case VLC_CODEC_FL32:
794         waveformat.Format.wBitsPerSample = sizeof(float) * 8;
795         waveformat.Samples.wValidBitsPerSample =
796             waveformat.Format.wBitsPerSample;
797         waveformat.Format.wFormatTag = WAVE_FORMAT_IEEE_FLOAT;
798         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_IEEE_FLOAT;
799         break;
800
801     case VLC_CODEC_S16L:
802         waveformat.Format.wBitsPerSample = 16;
803         waveformat.Samples.wValidBitsPerSample =
804             waveformat.Format.wBitsPerSample;
805         waveformat.Format.wFormatTag = WAVE_FORMAT_PCM;
806         waveformat.SubFormat = _KSDATAFORMAT_SUBTYPE_PCM;
807         break;
808     }
809
810     waveformat.Format.nChannels = i_nb_channels;
811     waveformat.Format.nSamplesPerSec = i_rate;
812     waveformat.Format.nBlockAlign =
813         waveformat.Format.wBitsPerSample / 8 * i_nb_channels;
814     waveformat.Format.nAvgBytesPerSec =
815         waveformat.Format.nSamplesPerSec * waveformat.Format.nBlockAlign;
816
817     p_aout->output.p_sys->i_bits_per_sample = waveformat.Format.wBitsPerSample;
818     p_aout->output.p_sys->i_channels = i_nb_channels;
819
820     /* Then fill in the direct sound descriptor */
821     memset(&dsbdesc, 0, sizeof(DSBUFFERDESC));
822     dsbdesc.dwSize = sizeof(DSBUFFERDESC);
823     dsbdesc.dwFlags = DSBCAPS_GETCURRENTPOSITION2/* Better position accuracy */
824                     | DSBCAPS_GLOBALFOCUS;      /* Allows background playing */
825
826     /* Only use the new WAVE_FORMAT_EXTENSIBLE format for multichannel audio */
827     if( i_nb_channels <= 2 )
828     {
829         waveformat.Format.cbSize = 0;
830     }
831     else
832     {
833         waveformat.Format.wFormatTag = WAVE_FORMAT_EXTENSIBLE;
834         waveformat.Format.cbSize =
835             sizeof(WAVEFORMATEXTENSIBLE) - sizeof(WAVEFORMATEX);
836
837         /* Needed for 5.1 on emu101k */
838         dsbdesc.dwFlags |= DSBCAPS_LOCHARDWARE;
839     }
840
841     dsbdesc.dwBufferBytes = FRAMES_NUM * i_bytes_per_frame;   /* buffer size */
842     dsbdesc.lpwfxFormat = (WAVEFORMATEX *)&waveformat;
843
844     if FAILED( IDirectSound_CreateSoundBuffer(
845                    p_aout->output.p_sys->p_dsobject, &dsbdesc,
846                    &p_aout->output.p_sys->p_dsbuffer, NULL) )
847     {
848         if( dsbdesc.dwFlags & DSBCAPS_LOCHARDWARE )
849         {
850             /* Try without DSBCAPS_LOCHARDWARE */
851             dsbdesc.dwFlags &= ~DSBCAPS_LOCHARDWARE;
852             if FAILED( IDirectSound_CreateSoundBuffer(
853                    p_aout->output.p_sys->p_dsobject, &dsbdesc,
854                    &p_aout->output.p_sys->p_dsbuffer, NULL) )
855             {
856                 return VLC_EGENERIC;
857             }
858             if( !b_probe )
859                 msg_Dbg( p_aout, "couldn't use hardware sound buffer" );
860         }
861         else
862         {
863             return VLC_EGENERIC;
864         }
865     }
866
867     /* Stop here if we were just probing */
868     if( b_probe )
869     {
870         IDirectSoundBuffer_Release( p_aout->output.p_sys->p_dsbuffer );
871         p_aout->output.p_sys->p_dsbuffer = NULL;
872         return VLC_SUCCESS;
873     }
874
875     p_aout->output.p_sys->i_frame_size = i_bytes_per_frame;
876     p_aout->output.p_sys->i_channel_mask = waveformat.dwChannelMask;
877     p_aout->output.p_sys->b_chan_reorder =
878         aout_CheckChannelReorder( pi_channels_in, pi_channels_out,
879                                   waveformat.dwChannelMask, i_nb_channels,
880                                   p_aout->output.p_sys->pi_chan_table );
881
882     if( p_aout->output.p_sys->b_chan_reorder )
883     {
884         msg_Dbg( p_aout, "channel reordering needed" );
885     }
886
887     return VLC_SUCCESS;
888 }
889
890 /*****************************************************************************
891  * CreateDSBufferPCM: creates a PCM direct sound buffer.
892  *****************************************************************************
893  * We first try to create a WAVE_FORMAT_IEEE_FLOAT buffer if supported by
894  * the hardware, otherwise we create a WAVE_FORMAT_PCM buffer.
895  ****************************************************************************/
896 static int CreateDSBufferPCM( aout_instance_t *p_aout, vlc_fourcc_t *i_format,
897                               int i_channels, int i_nb_channels, int i_rate,
898                               bool b_probe )
899 {
900     /* Float32 audio samples are not supported for 5.1 output on the emu101k */
901     if( !var_GetBool( p_aout, "directx-audio-float32" ) ||
902         i_nb_channels > 2 ||
903         CreateDSBuffer( p_aout, VLC_CODEC_FL32,
904                         i_channels, i_nb_channels, i_rate,
905                         FRAME_SIZE * 4 * i_nb_channels, b_probe )
906         != VLC_SUCCESS )
907     {
908         if ( CreateDSBuffer( p_aout, VLC_CODEC_S16L,
909                              i_channels, i_nb_channels, i_rate,
910                              FRAME_SIZE * 2 * i_nb_channels, b_probe )
911              != VLC_SUCCESS )
912         {
913             return VLC_EGENERIC;
914         }
915         else
916         {
917             *i_format = VLC_CODEC_S16L;
918             return VLC_SUCCESS;
919         }
920     }
921     else
922     {
923         *i_format = VLC_CODEC_FL32;
924         return VLC_SUCCESS;
925     }
926 }
927
928 /*****************************************************************************
929  * DestroyDSBuffer
930  *****************************************************************************
931  * This function destroys the secondary buffer.
932  *****************************************************************************/
933 static void DestroyDSBuffer( aout_instance_t *p_aout )
934 {
935     if( p_aout->output.p_sys->p_dsbuffer )
936     {
937         IDirectSoundBuffer_Release( p_aout->output.p_sys->p_dsbuffer );
938         p_aout->output.p_sys->p_dsbuffer = NULL;
939     }
940 }
941
942 /*****************************************************************************
943  * FillBuffer: Fill in one of the direct sound frame buffers.
944  *****************************************************************************
945  * Returns VLC_SUCCESS on success.
946  *****************************************************************************/
947 static int FillBuffer( aout_instance_t *p_aout, int i_frame,
948                        aout_buffer_t *p_buffer )
949 {
950     notification_thread_t *p_notif = p_aout->output.p_sys->p_notif;
951     aout_sys_t *p_sys = p_aout->output.p_sys;
952     void *p_write_position, *p_wrap_around;
953     unsigned long l_bytes1, l_bytes2;
954     HRESULT dsresult;
955
956     /* Before copying anything, we have to lock the buffer */
957     dsresult = IDirectSoundBuffer_Lock(
958                 p_sys->p_dsbuffer,                              /* DS buffer */
959                 i_frame * p_notif->i_frame_size,             /* Start offset */
960                 p_notif->i_frame_size,                    /* Number of bytes */
961                 &p_write_position,                  /* Address of lock start */
962                 &l_bytes1,       /* Count of bytes locked before wrap around */
963                 &p_wrap_around,            /* Buffer adress (if wrap around) */
964                 &l_bytes2,               /* Count of bytes after wrap around */
965                 0 );                                                /* Flags */
966     if( dsresult == DSERR_BUFFERLOST )
967     {
968         IDirectSoundBuffer_Restore( p_sys->p_dsbuffer );
969         dsresult = IDirectSoundBuffer_Lock(
970                                p_sys->p_dsbuffer,
971                                i_frame * p_notif->i_frame_size,
972                                p_notif->i_frame_size,
973                                &p_write_position,
974                                &l_bytes1,
975                                &p_wrap_around,
976                                &l_bytes2,
977                                0 );
978     }
979     if( dsresult != DS_OK )
980     {
981         msg_Warn( p_notif, "cannot lock buffer" );
982         if( p_buffer ) aout_BufferFree( p_buffer );
983         return VLC_EGENERIC;
984     }
985
986     if( p_buffer == NULL )
987     {
988         memset( p_write_position, 0, l_bytes1 );
989     }
990     else
991     {
992         if( p_sys->b_chan_reorder )
993         {
994             /* Do the channel reordering here */
995             aout_ChannelReorder( p_buffer->p_buffer, p_buffer->i_buffer,
996                                  p_sys->i_channels, p_sys->pi_chan_table,
997                                  p_sys->i_bits_per_sample );
998         }
999
1000         vlc_memcpy( p_write_position, p_buffer->p_buffer, l_bytes1 );
1001         aout_BufferFree( p_buffer );
1002     }
1003
1004     /* Now the data has been copied, unlock the buffer */
1005     IDirectSoundBuffer_Unlock( p_sys->p_dsbuffer, p_write_position, l_bytes1,
1006                                p_wrap_around, l_bytes2 );
1007
1008     p_notif->i_write_slot = (i_frame + 1) % FRAMES_NUM;
1009     return VLC_SUCCESS;
1010 }
1011
1012 /*****************************************************************************
1013  * DirectSoundThread: this thread will capture play notification events.
1014  *****************************************************************************
1015  * We use this thread to emulate a callback mechanism. The thread probes for
1016  * event notification and fills up the DS secondary buffer when needed.
1017  *****************************************************************************/
1018 static void* DirectSoundThread( vlc_object_t *p_this )
1019 {
1020     notification_thread_t *p_notif = (notification_thread_t*)p_this;
1021     aout_instance_t *p_aout = p_notif->p_aout;
1022     mtime_t last_time;
1023     int canc = vlc_savecancel ();
1024
1025     /* We don't want any resampling when using S/PDIF output */
1026     bool b_sleek = (p_aout->output.output.i_format == VLC_CODEC_SPDIFL);
1027
1028     msg_Dbg( p_notif, "DirectSoundThread ready" );
1029
1030     /* Wait here until Play() is called */
1031     WaitForSingleObject( p_notif->event, INFINITE );
1032
1033     if( vlc_object_alive (p_notif) )
1034     {
1035         HRESULT dsresult;
1036         mwait( p_notif->start_date - AOUT_PTS_TOLERANCE / 2 );
1037
1038         /* start playing the buffer */
1039         dsresult = IDirectSoundBuffer_Play( p_aout->output.p_sys->p_dsbuffer,
1040                                         0,                         /* Unused */
1041                                         0,                         /* Unused */
1042                                         DSBPLAY_LOOPING );          /* Flags */
1043         if( dsresult == DSERR_BUFFERLOST )
1044         {
1045             IDirectSoundBuffer_Restore( p_aout->output.p_sys->p_dsbuffer );
1046             dsresult = IDirectSoundBuffer_Play(
1047                                             p_aout->output.p_sys->p_dsbuffer,
1048                                             0,                     /* Unused */
1049                                             0,                     /* Unused */
1050                                             DSBPLAY_LOOPING );      /* Flags */
1051         }
1052         if( dsresult != DS_OK )
1053         {
1054             msg_Err( p_aout, "cannot start playing buffer" );
1055         }
1056     }
1057     last_time = mdate();
1058
1059     while( vlc_object_alive (p_notif) )
1060     {
1061         DWORD l_read;
1062         int l_queued = 0, l_free_slots;
1063         unsigned i_frame_siz = p_aout->output.i_nb_samples;
1064         mtime_t mtime = mdate();
1065         int i;
1066
1067         /*
1068          * Fill in as much audio data as we can in our circular buffer
1069          */
1070
1071         /* Find out current play position */
1072         if FAILED( IDirectSoundBuffer_GetCurrentPosition(
1073                    p_aout->output.p_sys->p_dsbuffer, &l_read, NULL ) )
1074         {
1075             msg_Err( p_aout, "GetCurrentPosition() failed!" );
1076             l_read = 0;
1077         }
1078
1079         /* Detect underruns */
1080         if( l_queued && mtime - last_time >
1081             INT64_C(1000000) * l_queued / p_aout->output.output.i_rate )
1082         {
1083             msg_Dbg( p_aout, "detected underrun!" );
1084         }
1085         last_time = mtime;
1086
1087         /* Try to fill in as many frame buffers as possible */
1088         l_read /= (p_aout->output.output.i_bytes_per_frame /
1089             p_aout->output.output.i_frame_length);
1090         l_queued = p_notif->i_write_slot * i_frame_siz - l_read;
1091         if( l_queued < 0 ) l_queued += (i_frame_siz * FRAMES_NUM);
1092         l_free_slots = (FRAMES_NUM * i_frame_siz - l_queued) / i_frame_siz;
1093
1094         for( i = 0; i < l_free_slots; i++ )
1095         {
1096             aout_buffer_t *p_buffer = aout_OutputNextBuffer( p_aout,
1097                 mtime + INT64_C(1000000) * (i * i_frame_siz + l_queued) /
1098                 p_aout->output.output.i_rate, b_sleek );
1099
1100             /* If there is no audio data available and we have some buffered
1101              * already, then just wait for the next time */
1102             if( !p_buffer && (i || l_queued / i_frame_siz) ) break;
1103
1104             if( FillBuffer( p_aout, p_notif->i_write_slot % FRAMES_NUM,
1105                             p_buffer ) != VLC_SUCCESS ) break;
1106         }
1107
1108         /* Sleep a reasonable amount of time */
1109         l_queued += (i * i_frame_siz);
1110         msleep( INT64_C(1000000) * l_queued / p_aout->output.output.i_rate / 2 );
1111     }
1112
1113     /* make sure the buffer isn't playing */
1114     IDirectSoundBuffer_Stop( p_aout->output.p_sys->p_dsbuffer );
1115
1116     /* free the event */
1117     CloseHandle( p_notif->event );
1118
1119     vlc_restorecancel (canc);
1120     msg_Dbg( p_notif, "DirectSoundThread exiting" );
1121     return NULL;
1122 }
1123
1124 /*****************************************************************************
1125  * CallBackConfigNBEnum: callback to get the number of available devices
1126  *****************************************************************************/
1127 static int CALLBACK CallBackConfigNBEnum( LPGUID p_guid, LPCWSTR psz_desc,
1128                                              LPCWSTR psz_mod, LPVOID p_nb )
1129 {
1130     VLC_UNUSED( psz_mod ); VLC_UNUSED( psz_desc ); VLC_UNUSED( p_guid );
1131
1132     int * a = (int *)p_nb;
1133     (*a)++;
1134     return true;
1135 }
1136
1137 /*****************************************************************************
1138  * CallBackConfigEnum: callback to add available devices to the preferences list
1139  *****************************************************************************/
1140 static int CALLBACK CallBackConfigEnum( LPGUID p_guid, LPCWSTR psz_desc,
1141                                              LPCWSTR psz_mod, LPVOID _p_item )
1142 {
1143     VLC_UNUSED( psz_mod ); VLC_UNUSED( p_guid );
1144
1145     module_config_t *p_item = (module_config_t *) _p_item;
1146
1147     p_item->ppsz_list[p_item->i_list] = FromWide( psz_desc );
1148     p_item->ppsz_list_text[p_item->i_list] = FromWide( psz_desc );
1149     p_item->i_list++;
1150     return true;
1151 }
1152
1153 /*****************************************************************************
1154  * ReloadDirectXDevices: store the list of devices in preferences
1155  *****************************************************************************/
1156 static int ReloadDirectXDevices( vlc_object_t *p_this, char const *psz_name,
1157                                  vlc_value_t newval, vlc_value_t oldval, void *data )
1158 {
1159     VLC_UNUSED( newval ); VLC_UNUSED( oldval ); VLC_UNUSED( data );
1160
1161     module_config_t *p_item = config_FindConfig( p_this, psz_name );
1162     if( !p_item ) return VLC_SUCCESS;
1163
1164     /* Clear-up the current list */
1165     if( p_item->i_list )
1166     {
1167         for( int i = 0; i < p_item->i_list; i++ )
1168         {
1169             free((char *)(p_item->ppsz_list[i]) );
1170             free((char *)(p_item->ppsz_list_text[i]) );
1171         }
1172     }
1173
1174     HRESULT (WINAPI *OurDirectSoundEnumerate)(LPDSENUMCALLBACKW, LPVOID);
1175
1176     HANDLE hdsound_dll = LoadLibrary("DSOUND.DLL");
1177     if( hdsound_dll == NULL )
1178     {
1179         msg_Warn( p_this, "cannot open DSOUND.DLL" );
1180         return VLC_SUCCESS;
1181     }
1182
1183     /* Get DirectSoundEnumerate */
1184     OurDirectSoundEnumerate = (void *)
1185                     GetProcAddress( hdsound_dll, "DirectSoundEnumerateW" );
1186
1187     if( OurDirectSoundEnumerate == NULL )
1188         goto error;
1189
1190     int nb_devices = 0;
1191     OurDirectSoundEnumerate(CallBackConfigNBEnum, &nb_devices);
1192     msg_Dbg(p_this,"found %d devices", nb_devices);
1193
1194     p_item->ppsz_list = xrealloc( p_item->ppsz_list,
1195                                   nb_devices * sizeof(char *) );
1196     p_item->ppsz_list_text = xrealloc( p_item->ppsz_list_text,
1197                                   nb_devices * sizeof(char *) );
1198
1199     p_item->i_list = 0;
1200     OurDirectSoundEnumerate(CallBackConfigEnum, p_item);
1201
1202     /* Signal change to the interface */
1203     p_item->b_dirty = true;
1204
1205 error:
1206     FreeLibrary(hdsound_dll);
1207
1208     return VLC_SUCCESS;
1209 }
1210