wined3d: Get rid of wined3d_buffer_get_desc().
[wine] / dlls / dsound / mixer.c
1 /*                      DirectSound
2  *
3  * Copyright 1998 Marcus Meissner
4  * Copyright 1998 Rob Riggs
5  * Copyright 2000-2002 TransGaming Technologies, Inc.
6  * Copyright 2007 Peter Dons Tychsen
7  * Copyright 2007 Maarten Lankhorst
8  * Copyright 2011 Owen Rudge for CodeWeavers
9  *
10  * This library is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Lesser General Public
12  * License as published by the Free Software Foundation; either
13  * version 2.1 of the License, or (at your option) any later version.
14  *
15  * This library is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * Lesser General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public
21  * License along with this library; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23  */
24
25 #include <assert.h>
26 #include <stdarg.h>
27 #include <math.h>       /* Insomnia - pow() function */
28
29 #define NONAMELESSSTRUCT
30 #define NONAMELESSUNION
31 #include "windef.h"
32 #include "winbase.h"
33 #include "mmsystem.h"
34 #include "wingdi.h"
35 #include "mmreg.h"
36 #include "winternl.h"
37 #include "wine/debug.h"
38 #include "dsound.h"
39 #include "ks.h"
40 #include "ksmedia.h"
41 #include "dsdriver.h"
42 #include "dsound_private.h"
43
44 WINE_DEFAULT_DEBUG_CHANNEL(dsound);
45
46 void DSOUND_RecalcVolPan(PDSVOLUMEPAN volpan)
47 {
48         double temp;
49         TRACE("(%p)\n",volpan);
50
51         TRACE("Vol=%d Pan=%d\n", volpan->lVolume, volpan->lPan);
52         /* the AmpFactors are expressed in 16.16 fixed point */
53         volpan->dwVolAmpFactor = (ULONG) (pow(2.0, volpan->lVolume / 600.0) * 0xffff);
54         /* FIXME: dwPan{Left|Right}AmpFactor */
55
56         /* FIXME: use calculated vol and pan ampfactors */
57         temp = (double) (volpan->lVolume - (volpan->lPan > 0 ? volpan->lPan : 0));
58         volpan->dwTotalLeftAmpFactor = (ULONG) (pow(2.0, temp / 600.0) * 0xffff);
59         temp = (double) (volpan->lVolume + (volpan->lPan < 0 ? volpan->lPan : 0));
60         volpan->dwTotalRightAmpFactor = (ULONG) (pow(2.0, temp / 600.0) * 0xffff);
61
62         TRACE("left = %x, right = %x\n", volpan->dwTotalLeftAmpFactor, volpan->dwTotalRightAmpFactor);
63 }
64
65 void DSOUND_AmpFactorToVolPan(PDSVOLUMEPAN volpan)
66 {
67     double left,right;
68     TRACE("(%p)\n",volpan);
69
70     TRACE("left=%x, right=%x\n",volpan->dwTotalLeftAmpFactor,volpan->dwTotalRightAmpFactor);
71     if (volpan->dwTotalLeftAmpFactor==0)
72         left=-10000;
73     else
74         left=600 * log(((double)volpan->dwTotalLeftAmpFactor) / 0xffff) / log(2);
75     if (volpan->dwTotalRightAmpFactor==0)
76         right=-10000;
77     else
78         right=600 * log(((double)volpan->dwTotalRightAmpFactor) / 0xffff) / log(2);
79     if (left<right)
80     {
81         volpan->lVolume=right;
82         volpan->dwVolAmpFactor=volpan->dwTotalRightAmpFactor;
83     }
84     else
85     {
86         volpan->lVolume=left;
87         volpan->dwVolAmpFactor=volpan->dwTotalLeftAmpFactor;
88     }
89     if (volpan->lVolume < -10000)
90         volpan->lVolume=-10000;
91     volpan->lPan=right-left;
92     if (volpan->lPan < -10000)
93         volpan->lPan=-10000;
94
95     TRACE("Vol=%d Pan=%d\n", volpan->lVolume, volpan->lPan);
96 }
97
98 /** Convert a primary buffer position to a pointer position for device->mix_buffer
99  * device: DirectSoundDevice for which to calculate
100  * pos: Primary buffer position to converts
101  * Returns: Offset for mix_buffer
102  */
103 DWORD DSOUND_bufpos_to_mixpos(const DirectSoundDevice* device, DWORD pos)
104 {
105     DWORD ret = pos * 32 / device->pwfx->wBitsPerSample;
106     if (device->pwfx->wBitsPerSample == 32)
107         ret *= 2;
108     return ret;
109 }
110
111 /* NOTE: Not all secpos have to always be mapped to a bufpos, other way around is always the case
112  * DWORD64 is used here because a single DWORD wouldn't be big enough to fit the freqAcc for big buffers
113  */
114 /** This function converts a 'native' sample pointer to a resampled pointer that fits for primary
115  * secmixpos is used to decide which freqAcc is needed
116  * overshot tells what the 'actual' secpos is now (optional)
117  */
118 DWORD DSOUND_secpos_to_bufpos(const IDirectSoundBufferImpl *dsb, DWORD secpos, DWORD secmixpos, DWORD* overshot)
119 {
120         DWORD64 framelen = secpos / dsb->pwfx->nBlockAlign;
121         DWORD64 freqAdjust = dsb->freqAdjust;
122         DWORD64 acc, freqAcc;
123
124         if (secpos < secmixpos)
125                 freqAcc = dsb->freqAccNext;
126         else freqAcc = dsb->freqAcc;
127         acc = (framelen << DSOUND_FREQSHIFT) + (freqAdjust - 1 - freqAcc);
128         acc /= freqAdjust;
129         if (overshot)
130         {
131                 DWORD64 oshot = acc * freqAdjust + freqAcc;
132                 assert(oshot >= framelen << DSOUND_FREQSHIFT);
133                 oshot -= framelen << DSOUND_FREQSHIFT;
134                 *overshot = (DWORD)oshot;
135                 assert(*overshot < dsb->freqAdjust);
136         }
137         return (DWORD)acc * dsb->device->pwfx->nBlockAlign;
138 }
139
140 /** Convert a resampled pointer that fits for primary to a 'native' sample pointer
141  * freqAccNext is used here rather than freqAcc: In case the app wants to fill up to
142  * the play position it won't overwrite it
143  */
144 static DWORD DSOUND_bufpos_to_secpos(const IDirectSoundBufferImpl *dsb, DWORD bufpos)
145 {
146         DWORD oAdv = dsb->device->pwfx->nBlockAlign, iAdv = dsb->pwfx->nBlockAlign, pos;
147         DWORD64 framelen;
148         DWORD64 acc;
149
150         framelen = bufpos/oAdv;
151         acc = framelen * (DWORD64)dsb->freqAdjust + (DWORD64)dsb->freqAccNext;
152         acc = acc >> DSOUND_FREQSHIFT;
153         pos = (DWORD)acc * iAdv;
154         if (pos >= dsb->buflen)
155                 /* Because of differences between freqAcc and freqAccNext, this might happen */
156                 pos = dsb->buflen - iAdv;
157         TRACE("Converted %d/%d to %d/%d\n", bufpos, dsb->tmp_buffer_len, pos, dsb->buflen);
158         return pos;
159 }
160
161 /**
162  * Move freqAccNext to freqAcc, and find new values for buffer length and freqAccNext
163  */
164 static void DSOUND_RecalcFreqAcc(IDirectSoundBufferImpl *dsb)
165 {
166         if (!dsb->freqneeded) return;
167         dsb->freqAcc = dsb->freqAccNext;
168         dsb->tmp_buffer_len = DSOUND_secpos_to_bufpos(dsb, dsb->buflen, 0, &dsb->freqAccNext);
169         TRACE("New freqadjust: %04x, new buflen: %d\n", dsb->freqAccNext, dsb->tmp_buffer_len);
170 }
171
172 /**
173  * Recalculate the size for temporary buffer, and new writelead
174  * Should be called when one of the following things occur:
175  * - Primary buffer format is changed
176  * - This buffer format (frequency) is changed
177  *
178  * After this, DSOUND_MixToTemporary(dsb, 0, dsb->buflen) should
179  * be called to refill the temporary buffer with data.
180  */
181 void DSOUND_RecalcFormat(IDirectSoundBufferImpl *dsb)
182 {
183         BOOL needremix = TRUE, needresample = (dsb->freq != dsb->device->pwfx->nSamplesPerSec);
184         DWORD bAlign = dsb->pwfx->nBlockAlign, pAlign = dsb->device->pwfx->nBlockAlign;
185         WAVEFORMATEXTENSIBLE *pwfxe;
186         BOOL ieee = FALSE;
187
188         TRACE("(%p)\n",dsb);
189
190         pwfxe = (WAVEFORMATEXTENSIBLE *) dsb->pwfx;
191
192         if ((pwfxe->Format.wFormatTag == WAVE_FORMAT_IEEE_FLOAT) || ((pwfxe->Format.wFormatTag == WAVE_FORMAT_EXTENSIBLE)
193             && (IsEqualGUID(&pwfxe->SubFormat, &KSDATAFORMAT_SUBTYPE_IEEE_FLOAT))))
194                 ieee = TRUE;
195
196         /* calculate the 10ms write lead */
197         dsb->writelead = (dsb->freq / 100) * dsb->pwfx->nBlockAlign;
198
199         if ((dsb->pwfx->wBitsPerSample == dsb->device->pwfx->wBitsPerSample) &&
200             (dsb->pwfx->nChannels == dsb->device->pwfx->nChannels) && !needresample && !ieee)
201                 needremix = FALSE;
202         HeapFree(GetProcessHeap(), 0, dsb->tmp_buffer);
203         dsb->tmp_buffer = NULL;
204         dsb->max_buffer_len = dsb->freqAcc = dsb->freqAccNext = 0;
205         dsb->freqneeded = needresample;
206
207         if (ieee)
208                 dsb->convert = convertbpp[4][dsb->device->pwfx->wBitsPerSample/8 - 1];
209         else
210                 dsb->convert = convertbpp[dsb->pwfx->wBitsPerSample/8 - 1][dsb->device->pwfx->wBitsPerSample/8 - 1];
211
212         dsb->resampleinmixer = FALSE;
213
214         if (needremix)
215         {
216                 if (needresample)
217                         DSOUND_RecalcFreqAcc(dsb);
218                 else
219                         dsb->tmp_buffer_len = dsb->buflen / bAlign * pAlign;
220                 dsb->max_buffer_len = dsb->tmp_buffer_len;
221                 if ((dsb->max_buffer_len <= dsb->device->buflen || dsb->max_buffer_len < ds_snd_shadow_maxsize * 1024 * 1024) && ds_snd_shadow_maxsize >= 0)
222                         dsb->tmp_buffer = HeapAlloc(GetProcessHeap(), 0, dsb->max_buffer_len);
223                 if (dsb->tmp_buffer)
224                         FillMemory(dsb->tmp_buffer, dsb->tmp_buffer_len, dsb->device->pwfx->wBitsPerSample == 8 ? 128 : 0);
225                 else
226                         dsb->resampleinmixer = TRUE;
227         }
228         else dsb->max_buffer_len = dsb->tmp_buffer_len = dsb->buflen;
229         dsb->buf_mixpos = DSOUND_secpos_to_bufpos(dsb, dsb->sec_mixpos, 0, NULL);
230 }
231
232 /**
233  * Check for application callback requests for when the play position
234  * reaches certain points.
235  *
236  * The offsets that will be triggered will be those between the recorded
237  * "last played" position for the buffer (i.e. dsb->playpos) and "len" bytes
238  * beyond that position.
239  */
240 void DSOUND_CheckEvent(const IDirectSoundBufferImpl *dsb, DWORD playpos, int len)
241 {
242         int                     i;
243         DWORD                   offset;
244         LPDSBPOSITIONNOTIFY     event;
245         TRACE("(%p,%d)\n",dsb,len);
246
247         if (dsb->nrofnotifies == 0)
248                 return;
249
250         TRACE("(%p) buflen = %d, playpos = %d, len = %d\n",
251                 dsb, dsb->buflen, playpos, len);
252         for (i = 0; i < dsb->nrofnotifies ; i++) {
253                 event = dsb->notifies + i;
254                 offset = event->dwOffset;
255                 TRACE("checking %d, position %d, event = %p\n",
256                         i, offset, event->hEventNotify);
257                 /* DSBPN_OFFSETSTOP has to be the last element. So this is */
258                 /* OK. [Inside DirectX, p274] */
259                 /* Windows does not seem to enforce this, and some apps rely */
260                 /* on that, so we can't stop there. */
261                 /*  */
262                 /* This also means we can't sort the entries by offset, */
263                 /* because DSBPN_OFFSETSTOP == -1 */
264                 if (offset == DSBPN_OFFSETSTOP) {
265                         if (dsb->state == STATE_STOPPED) {
266                                 SetEvent(event->hEventNotify);
267                                 TRACE("signalled event %p (%d)\n", event->hEventNotify, i);
268                         }
269                         continue;
270                 }
271                 if ((playpos + len) >= dsb->buflen) {
272                         if ((offset < ((playpos + len) % dsb->buflen)) ||
273                             (offset >= playpos)) {
274                                 TRACE("signalled event %p (%d)\n", event->hEventNotify, i);
275                                 SetEvent(event->hEventNotify);
276                         }
277                 } else {
278                         if ((offset >= playpos) && (offset < (playpos + len))) {
279                                 TRACE("signalled event %p (%d)\n", event->hEventNotify, i);
280                                 SetEvent(event->hEventNotify);
281                         }
282                 }
283         }
284 }
285
286 /**
287  * Copy a single frame from the given input buffer to the given output buffer.
288  * Translate 8 <-> 16 bits and mono <-> stereo
289  */
290 static inline void cp_fields(const IDirectSoundBufferImpl *dsb, const BYTE *ibuf, BYTE *obuf,
291         UINT istride, UINT ostride, UINT count, UINT freqAcc, UINT adj)
292 {
293     DirectSoundDevice *device = dsb->device;
294     INT istep = dsb->pwfx->wBitsPerSample / 8, ostep = device->pwfx->wBitsPerSample / 8;
295
296     if (device->pwfx->nChannels == dsb->pwfx->nChannels ||
297         (device->pwfx->nChannels == 2 && dsb->pwfx->nChannels == 6) ||
298         (device->pwfx->nChannels == 6 && dsb->pwfx->nChannels == 2)) {
299         dsb->convert(ibuf, obuf, istride, ostride, count, freqAcc, adj);
300         if (device->pwfx->nChannels == 2 || dsb->pwfx->nChannels == 2)
301             dsb->convert(ibuf + istep, obuf + ostep, istride, ostride, count, freqAcc, adj);
302         return;
303     }
304
305     if (device->pwfx->nChannels == 1 && dsb->pwfx->nChannels == 2)
306     {
307         dsb->convert(ibuf, obuf, istride, ostride, count, freqAcc, adj);
308         return;
309     }
310
311     if (device->pwfx->nChannels == 2 && dsb->pwfx->nChannels == 1)
312     {
313         dsb->convert(ibuf, obuf, istride, ostride, count, freqAcc, adj);
314         dsb->convert(ibuf, obuf + ostep, istride, ostride, count, freqAcc, adj);
315         return;
316     }
317
318     WARN("Unable to remap channels: device=%u, buffer=%u\n", device->pwfx->nChannels,
319             dsb->pwfx->nChannels);
320 }
321
322 /**
323  * Calculate the distance between two buffer offsets, taking wraparound
324  * into account.
325  */
326 static inline DWORD DSOUND_BufPtrDiff(DWORD buflen, DWORD ptr1, DWORD ptr2)
327 {
328 /* If these asserts fail, the problem is not here, but in the underlying code */
329         assert(ptr1 < buflen);
330         assert(ptr2 < buflen);
331         if (ptr1 >= ptr2) {
332                 return ptr1 - ptr2;
333         } else {
334                 return buflen + ptr1 - ptr2;
335         }
336 }
337 /**
338  * Mix at most the given amount of data into the allocated temporary buffer
339  * of the given secondary buffer, starting from the dsb's first currently
340  * unsampled frame (writepos), translating frequency (pitch), stereo/mono
341  * and bits-per-sample so that it is ideal for the primary buffer.
342  * Doesn't perform any mixing - this is a straight copy/convert operation.
343  *
344  * dsb = the secondary buffer
345  * writepos = Starting position of changed buffer
346  * len = number of bytes to resample from writepos
347  *
348  * NOTE: writepos + len <= buflen. When called by mixer, MixOne makes sure of this.
349  */
350 void DSOUND_MixToTemporary(const IDirectSoundBufferImpl *dsb, DWORD writepos, DWORD len, BOOL inmixer)
351 {
352         INT     size;
353         BYTE    *ibp, *obp, *obp_begin;
354         INT     iAdvance = dsb->pwfx->nBlockAlign;
355         INT     oAdvance = dsb->device->pwfx->nBlockAlign;
356         DWORD freqAcc, target_writepos = 0, overshot, maxlen;
357
358         /* We resample only when needed */
359         if ((dsb->tmp_buffer && inmixer) || (!dsb->tmp_buffer && !inmixer) || dsb->resampleinmixer != inmixer)
360                 return;
361
362         assert(writepos + len <= dsb->buflen);
363         if (inmixer && writepos + len < dsb->buflen)
364                 len += dsb->pwfx->nBlockAlign;
365
366         maxlen = DSOUND_secpos_to_bufpos(dsb, len, 0, NULL);
367
368         ibp = dsb->buffer->memory + writepos;
369         if (!inmixer)
370                 obp_begin = dsb->tmp_buffer;
371         else if (dsb->device->tmp_buffer_len < maxlen || !dsb->device->tmp_buffer)
372         {
373                 dsb->device->tmp_buffer_len = maxlen;
374                 if (dsb->device->tmp_buffer)
375                         dsb->device->tmp_buffer = HeapReAlloc(GetProcessHeap(), 0, dsb->device->tmp_buffer, maxlen);
376                 else
377                         dsb->device->tmp_buffer = HeapAlloc(GetProcessHeap(), 0, maxlen);
378                 obp_begin = dsb->device->tmp_buffer;
379         }
380         else
381                 obp_begin = dsb->device->tmp_buffer;
382
383         TRACE("(%p, %p)\n", dsb, ibp);
384         size = len / iAdvance;
385
386         /* Check for same sample rate */
387         if (dsb->freq == dsb->device->pwfx->nSamplesPerSec) {
388                 TRACE("(%p) Same sample rate %d = primary %d\n", dsb,
389                         dsb->freq, dsb->device->pwfx->nSamplesPerSec);
390                 obp = obp_begin;
391                 if (!inmixer)
392                          obp += writepos/iAdvance*oAdvance;
393
394                 cp_fields(dsb, ibp, obp, iAdvance, oAdvance, size, 0, 1 << DSOUND_FREQSHIFT);
395                 return;
396         }
397
398         /* Mix in different sample rates */
399         TRACE("(%p) Adjusting frequency: %d -> %d\n", dsb, dsb->freq, dsb->device->pwfx->nSamplesPerSec);
400
401         target_writepos = DSOUND_secpos_to_bufpos(dsb, writepos, dsb->sec_mixpos, &freqAcc);
402         overshot = freqAcc >> DSOUND_FREQSHIFT;
403         if (overshot)
404         {
405                 if (overshot >= size)
406                         return;
407                 size -= overshot;
408                 writepos += overshot * iAdvance;
409                 if (writepos >= dsb->buflen)
410                         return;
411                 ibp = dsb->buffer->memory + writepos;
412                 freqAcc &= (1 << DSOUND_FREQSHIFT) - 1;
413                 TRACE("Overshot: %d, freqAcc: %04x\n", overshot, freqAcc);
414         }
415
416         if (!inmixer)
417                 obp = obp_begin + target_writepos;
418         else obp = obp_begin;
419
420         /* FIXME: Small problem here when we're overwriting buf_mixpos, it then STILL uses old freqAcc, not sure if it matters or not */
421         cp_fields(dsb, ibp, obp, iAdvance, oAdvance, size, freqAcc, dsb->freqAdjust);
422 }
423
424 /** Apply volume to the given soundbuffer from (primary) position writepos and length len
425  * Returns: NULL if no volume needs to be applied
426  * or else a memory handle that holds 'len' volume adjusted buffer */
427 static LPBYTE DSOUND_MixerVol(const IDirectSoundBufferImpl *dsb, INT len)
428 {
429         INT     i;
430         BYTE    *bpc;
431         INT16   *bps, *mems;
432         DWORD vLeft, vRight;
433         INT nChannels = dsb->device->pwfx->nChannels;
434         LPBYTE mem = (dsb->tmp_buffer ? dsb->tmp_buffer : dsb->buffer->memory) + dsb->buf_mixpos;
435
436         if (dsb->resampleinmixer)
437                 mem = dsb->device->tmp_buffer;
438
439         TRACE("(%p,%d)\n",dsb,len);
440         TRACE("left = %x, right = %x\n", dsb->volpan.dwTotalLeftAmpFactor,
441                 dsb->volpan.dwTotalRightAmpFactor);
442
443         if ((!(dsb->dsbd.dwFlags & DSBCAPS_CTRLPAN) || (dsb->volpan.lPan == 0)) &&
444             (!(dsb->dsbd.dwFlags & DSBCAPS_CTRLVOLUME) || (dsb->volpan.lVolume == 0)) &&
445              !(dsb->dsbd.dwFlags & DSBCAPS_CTRL3D))
446                 return NULL; /* Nothing to do */
447
448         if (nChannels != 1 && nChannels != 2)
449         {
450                 FIXME("There is no support for %d channels\n", nChannels);
451                 return NULL;
452         }
453
454         if (dsb->device->pwfx->wBitsPerSample != 8 && dsb->device->pwfx->wBitsPerSample != 16)
455         {
456                 FIXME("There is no support for %d bpp\n", dsb->device->pwfx->wBitsPerSample);
457                 return NULL;
458         }
459
460         if (dsb->device->tmp_buffer_len < len || !dsb->device->tmp_buffer)
461         {
462                 /* If we just resampled in DSOUND_MixToTemporary, we shouldn't need to resize here */
463                 assert(!dsb->resampleinmixer);
464                 dsb->device->tmp_buffer_len = len;
465                 if (dsb->device->tmp_buffer)
466                         dsb->device->tmp_buffer = HeapReAlloc(GetProcessHeap(), 0, dsb->device->tmp_buffer, len);
467                 else
468                         dsb->device->tmp_buffer = HeapAlloc(GetProcessHeap(), 0, len);
469         }
470
471         bpc = dsb->device->tmp_buffer;
472         bps = (INT16 *)bpc;
473         mems = (INT16 *)mem;
474         vLeft = dsb->volpan.dwTotalLeftAmpFactor;
475         if (nChannels > 1)
476                 vRight = dsb->volpan.dwTotalRightAmpFactor;
477         else
478                 vRight = vLeft;
479
480         switch (dsb->device->pwfx->wBitsPerSample) {
481         case 8:
482                 /* 8-bit WAV is unsigned, but we need to operate */
483                 /* on signed data for this to work properly */
484                 for (i = 0; i < len-1; i+=2) {
485                         *(bpc++) = (((*(mem++) - 128) * vLeft) >> 16) + 128;
486                         *(bpc++) = (((*(mem++) - 128) * vRight) >> 16) + 128;
487                 }
488                 if (len % 2 == 1 && nChannels == 1)
489                         *(bpc++) = (((*(mem++) - 128) * vLeft) >> 16) + 128;
490                 break;
491         case 16:
492                 /* 16-bit WAV is signed -- much better */
493                 for (i = 0; i < len-3; i += 4) {
494                         *(bps++) = (*(mems++) * vLeft) >> 16;
495                         *(bps++) = (*(mems++) * vRight) >> 16;
496                 }
497                 if (len % 4 == 2 && nChannels == 1)
498                         *(bps++) = ((INT)*(mems++) * vLeft) >> 16;
499                 break;
500         }
501         return dsb->device->tmp_buffer;
502 }
503
504 /**
505  * Mix (at most) the given number of bytes into the given position of the
506  * device buffer, from the secondary buffer "dsb" (starting at the current
507  * mix position for that buffer).
508  *
509  * Returns the number of bytes actually mixed into the device buffer. This
510  * will match fraglen unless the end of the secondary buffer is reached
511  * (and it is not looping).
512  *
513  * dsb  = the secondary buffer to mix from
514  * writepos = position (offset) in device buffer to write at
515  * fraglen = number of bytes to mix
516  */
517 static DWORD DSOUND_MixInBuffer(IDirectSoundBufferImpl *dsb, DWORD writepos, DWORD fraglen)
518 {
519         INT len = fraglen, ilen;
520         BYTE *ibuf = (dsb->tmp_buffer ? dsb->tmp_buffer : dsb->buffer->memory) + dsb->buf_mixpos, *volbuf;
521         DWORD oldpos, mixbufpos;
522
523         TRACE("buf_mixpos=%d/%d sec_mixpos=%d/%d\n", dsb->buf_mixpos, dsb->tmp_buffer_len, dsb->sec_mixpos, dsb->buflen);
524         TRACE("(%p,%d,%d)\n",dsb,writepos,fraglen);
525
526         assert(dsb->buf_mixpos + len <= dsb->tmp_buffer_len);
527
528         if (len % dsb->device->pwfx->nBlockAlign) {
529                 INT nBlockAlign = dsb->device->pwfx->nBlockAlign;
530                 ERR("length not a multiple of block size, len = %d, block size = %d\n", len, nBlockAlign);
531                 len -= len % nBlockAlign; /* data alignment */
532         }
533
534         /* Resample buffer to temporary buffer specifically allocated for this purpose, if needed */
535         DSOUND_MixToTemporary(dsb, dsb->sec_mixpos, DSOUND_bufpos_to_secpos(dsb, dsb->buf_mixpos+len) - dsb->sec_mixpos, TRUE);
536         if (dsb->resampleinmixer)
537                 ibuf = dsb->device->tmp_buffer;
538
539         /* Apply volume if needed */
540         volbuf = DSOUND_MixerVol(dsb, len);
541         if (volbuf)
542                 ibuf = volbuf;
543
544         mixbufpos = DSOUND_bufpos_to_mixpos(dsb->device, writepos);
545         /* Now mix the temporary buffer into the devices main buffer */
546         if ((writepos + len) <= dsb->device->buflen)
547                 dsb->device->mixfunction(ibuf, dsb->device->mix_buffer + mixbufpos, len);
548         else
549         {
550                 DWORD todo = dsb->device->buflen - writepos;
551                 dsb->device->mixfunction(ibuf, dsb->device->mix_buffer + mixbufpos, todo);
552                 dsb->device->mixfunction(ibuf + todo, dsb->device->mix_buffer, len - todo);
553         }
554
555         oldpos = dsb->sec_mixpos;
556         dsb->buf_mixpos += len;
557
558         if (dsb->buf_mixpos >= dsb->tmp_buffer_len) {
559                 if (dsb->buf_mixpos > dsb->tmp_buffer_len)
560                         ERR("Mixpos (%u) past buflen (%u), capping...\n", dsb->buf_mixpos, dsb->tmp_buffer_len);
561                 if (dsb->playflags & DSBPLAY_LOOPING) {
562                         dsb->buf_mixpos -= dsb->tmp_buffer_len;
563                 } else if (dsb->buf_mixpos >= dsb->tmp_buffer_len) {
564                         dsb->buf_mixpos = dsb->sec_mixpos = 0;
565                         dsb->state = STATE_STOPPED;
566                 }
567                 DSOUND_RecalcFreqAcc(dsb);
568         }
569
570         dsb->sec_mixpos = DSOUND_bufpos_to_secpos(dsb, dsb->buf_mixpos);
571         ilen = DSOUND_BufPtrDiff(dsb->buflen, dsb->sec_mixpos, oldpos);
572         /* check for notification positions */
573         if (dsb->dsbd.dwFlags & DSBCAPS_CTRLPOSITIONNOTIFY &&
574             dsb->state != STATE_STARTING) {
575                 DSOUND_CheckEvent(dsb, oldpos, ilen);
576         }
577
578         /* increase mix position */
579         dsb->primary_mixpos += len;
580         if (dsb->primary_mixpos >= dsb->device->buflen)
581                 dsb->primary_mixpos -= dsb->device->buflen;
582         return len;
583 }
584
585 /**
586  * Mix some frames from the given secondary buffer "dsb" into the device
587  * primary buffer.
588  *
589  * dsb = the secondary buffer
590  * playpos = the current play position in the device buffer (primary buffer)
591  * writepos = the current safe-to-write position in the device buffer
592  * mixlen = the maximum number of bytes in the primary buffer to mix, from the
593  *          current writepos.
594  *
595  * Returns: the number of bytes beyond the writepos that were mixed.
596  */
597 static DWORD DSOUND_MixOne(IDirectSoundBufferImpl *dsb, DWORD writepos, DWORD mixlen)
598 {
599         /* The buffer's primary_mixpos may be before or after the device
600          * buffer's mixpos, but both must be ahead of writepos. */
601         DWORD primary_done;
602
603         TRACE("(%p,%d,%d)\n",dsb,writepos,mixlen);
604         TRACE("writepos=%d, buf_mixpos=%d, primary_mixpos=%d, mixlen=%d\n", writepos, dsb->buf_mixpos, dsb->primary_mixpos, mixlen);
605         TRACE("looping=%d, leadin=%d, buflen=%d\n", dsb->playflags, dsb->leadin, dsb->tmp_buffer_len);
606
607         /* If leading in, only mix about 20 ms, and 'skip' mixing the rest, for more fluid pointer advancement */
608         if (dsb->leadin && dsb->state == STATE_STARTING)
609         {
610                 if (mixlen > 2 * dsb->device->fraglen)
611                 {
612                         dsb->primary_mixpos += mixlen - 2 * dsb->device->fraglen;
613                         dsb->primary_mixpos %= dsb->device->buflen;
614                 }
615         }
616         dsb->leadin = FALSE;
617
618         /* calculate how much pre-buffering has already been done for this buffer */
619         primary_done = DSOUND_BufPtrDiff(dsb->device->buflen, dsb->primary_mixpos, writepos);
620
621         /* sanity */
622         if(mixlen < primary_done)
623         {
624                 /* Should *NEVER* happen */
625                 ERR("Fatal error. Under/Overflow? primary_done=%d, mixpos=%d/%d (%d/%d), primary_mixpos=%d, writepos=%d, mixlen=%d\n", primary_done,dsb->buf_mixpos,dsb->tmp_buffer_len,dsb->sec_mixpos, dsb->buflen, dsb->primary_mixpos, writepos, mixlen);
626                 dsb->primary_mixpos = writepos + mixlen;
627                 dsb->primary_mixpos %= dsb->device->buflen;
628                 return mixlen;
629         }
630
631         /* take into account already mixed data */
632         mixlen -= primary_done;
633
634         TRACE("primary_done=%d, mixlen (primary) = %i\n", primary_done, mixlen);
635
636         if (!mixlen)
637                 return primary_done;
638
639         /* First try to mix to the end of the buffer if possible
640          * Theoretically it would allow for better optimization
641         */
642         if (mixlen + dsb->buf_mixpos >= dsb->tmp_buffer_len)
643         {
644                 DWORD newmixed, mixfirst = dsb->tmp_buffer_len - dsb->buf_mixpos;
645                 newmixed = DSOUND_MixInBuffer(dsb, dsb->primary_mixpos, mixfirst);
646                 mixlen -= newmixed;
647
648                 if (dsb->playflags & DSBPLAY_LOOPING)
649                         while (newmixed && mixlen)
650                         {
651                                 mixfirst = (dsb->tmp_buffer_len < mixlen ? dsb->tmp_buffer_len : mixlen);
652                                 newmixed = DSOUND_MixInBuffer(dsb, dsb->primary_mixpos, mixfirst);
653                                 mixlen -= newmixed;
654                         }
655         }
656         else DSOUND_MixInBuffer(dsb, dsb->primary_mixpos, mixlen);
657
658         /* re-calculate the primary done */
659         primary_done = DSOUND_BufPtrDiff(dsb->device->buflen, dsb->primary_mixpos, writepos);
660
661         TRACE("new primary_mixpos=%d, total mixed data=%d\n", dsb->primary_mixpos, primary_done);
662
663         /* Report back the total prebuffered amount for this buffer */
664         return primary_done;
665 }
666
667 /**
668  * For a DirectSoundDevice, go through all the currently playing buffers and
669  * mix them in to the device buffer.
670  *
671  * writepos = the current safe-to-write position in the primary buffer
672  * mixlen = the maximum amount to mix into the primary buffer
673  *          (beyond the current writepos)
674  * recover = true if the sound device may have been reset and the write
675  *           position in the device buffer changed
676  * all_stopped = reports back if all buffers have stopped
677  *
678  * Returns:  the length beyond the writepos that was mixed to.
679  */
680
681 static DWORD DSOUND_MixToPrimary(const DirectSoundDevice *device, DWORD writepos, DWORD mixlen, BOOL recover, BOOL *all_stopped)
682 {
683         INT i, len;
684         DWORD minlen = 0;
685         IDirectSoundBufferImpl  *dsb;
686
687         /* unless we find a running buffer, all have stopped */
688         *all_stopped = TRUE;
689
690         TRACE("(%d,%d,%d)\n", writepos, mixlen, recover);
691         for (i = 0; i < device->nrofbuffers; i++) {
692                 dsb = device->buffers[i];
693
694                 TRACE("MixToPrimary for %p, state=%d\n", dsb, dsb->state);
695
696                 if (dsb->buflen && dsb->state && !dsb->hwbuf) {
697                         TRACE("Checking %p, mixlen=%d\n", dsb, mixlen);
698                         RtlAcquireResourceShared(&dsb->lock, TRUE);
699                         /* if buffer is stopping it is stopped now */
700                         if (dsb->state == STATE_STOPPING) {
701                                 dsb->state = STATE_STOPPED;
702                                 DSOUND_CheckEvent(dsb, 0, 0);
703                         } else if (dsb->state != STATE_STOPPED) {
704
705                                 /* if recovering, reset the mix position */
706                                 if ((dsb->state == STATE_STARTING) || recover) {
707                                         dsb->primary_mixpos = writepos;
708                                 }
709
710                                 /* if the buffer was starting, it must be playing now */
711                                 if (dsb->state == STATE_STARTING)
712                                         dsb->state = STATE_PLAYING;
713
714                                 /* mix next buffer into the main buffer */
715                                 len = DSOUND_MixOne(dsb, writepos, mixlen);
716
717                                 if (!minlen) minlen = len;
718
719                                 /* record the minimum length mixed from all buffers */
720                                 /* we only want to return the length which *all* buffers have mixed */
721                                 else if (len) minlen = (len < minlen) ? len : minlen;
722
723                                 *all_stopped = FALSE;
724                         }
725                         RtlReleaseResource(&dsb->lock);
726                 }
727         }
728
729         TRACE("Mixed at least %d from all buffers\n", minlen);
730         return minlen;
731 }
732
733 /**
734  * Add buffers to the emulated wave device system.
735  *
736  * device = The current dsound playback device
737  * force = If TRUE, the function will buffer up as many frags as possible,
738  *         even though and will ignore the actual state of the primary buffer.
739  *
740  * Returns:  None
741  */
742
743 static void DSOUND_WaveQueue(DirectSoundDevice *device, BOOL force)
744 {
745         DWORD prebuf_frags, wave_writepos, wave_fragpos, i;
746         TRACE("(%p)\n", device);
747
748         /* calculate the current wave frag position */
749         wave_fragpos = (device->pwplay + device->pwqueue) % device->helfrags;
750
751         /* calculate the current wave write position */
752         wave_writepos = wave_fragpos * device->fraglen;
753
754         TRACE("wave_fragpos = %i, wave_writepos = %i, pwqueue = %i, prebuf = %i\n",
755                 wave_fragpos, wave_writepos, device->pwqueue, device->prebuf);
756
757         if (!force)
758         {
759                 /* check remaining prebuffered frags */
760                 prebuf_frags = device->mixpos / device->fraglen;
761                 if (prebuf_frags == device->helfrags)
762                         --prebuf_frags;
763                 TRACE("wave_fragpos = %d, mixpos_frags = %d\n", wave_fragpos, prebuf_frags);
764                 if (prebuf_frags < wave_fragpos)
765                         prebuf_frags += device->helfrags;
766                 prebuf_frags -= wave_fragpos;
767                 TRACE("wanted prebuf_frags = %d\n", prebuf_frags);
768         }
769         else
770                 /* buffer the maximum amount of frags */
771                 prebuf_frags = device->prebuf;
772
773         /* limit to the queue we have left */
774         if ((prebuf_frags + device->pwqueue) > device->prebuf)
775                 prebuf_frags = device->prebuf - device->pwqueue;
776
777         TRACE("prebuf_frags = %i\n", prebuf_frags);
778
779         /* adjust queue */
780         device->pwqueue += prebuf_frags;
781
782         /* get out of CS when calling the wave system */
783         LeaveCriticalSection(&(device->mixlock));
784         /* **** */
785
786         /* queue up the new buffers */
787         for(i=0; i<prebuf_frags; i++){
788                 TRACE("queueing wave buffer %i\n", wave_fragpos);
789                 waveOutWrite(device->hwo, &device->pwave[wave_fragpos], sizeof(WAVEHDR));
790                 wave_fragpos++;
791                 wave_fragpos %= device->helfrags;
792         }
793
794         /* **** */
795         EnterCriticalSection(&(device->mixlock));
796
797         TRACE("queue now = %i\n", device->pwqueue);
798 }
799
800 /**
801  * Perform mixing for a Direct Sound device. That is, go through all the
802  * secondary buffers (the sound bites currently playing) and mix them in
803  * to the primary buffer (the device buffer).
804  */
805 static void DSOUND_PerformMix(DirectSoundDevice *device)
806 {
807         TRACE("(%p)\n", device);
808
809         /* **** */
810         EnterCriticalSection(&(device->mixlock));
811
812         if (device->priolevel != DSSCL_WRITEPRIMARY) {
813                 BOOL recover = FALSE, all_stopped = FALSE;
814                 DWORD playpos, writepos, writelead, maxq, frag, prebuff_max, prebuff_left, size1, size2, mixplaypos, mixplaypos2;
815                 LPVOID buf1, buf2;
816                 BOOL lock = (device->hwbuf && !(device->drvdesc.dwFlags & DSDDESC_DONTNEEDPRIMARYLOCK));
817                 int nfiller;
818
819                 /* the sound of silence */
820                 nfiller = device->pwfx->wBitsPerSample == 8 ? 128 : 0;
821
822                 /* get the position in the primary buffer */
823                 if (DSOUND_PrimaryGetPosition(device, &playpos, &writepos) != 0){
824                         LeaveCriticalSection(&(device->mixlock));
825                         return;
826                 }
827
828                 TRACE("primary playpos=%d, writepos=%d, clrpos=%d, mixpos=%d, buflen=%d\n",
829                       playpos,writepos,device->playpos,device->mixpos,device->buflen);
830                 assert(device->playpos < device->buflen);
831
832                 mixplaypos = DSOUND_bufpos_to_mixpos(device, device->playpos);
833                 mixplaypos2 = DSOUND_bufpos_to_mixpos(device, playpos);
834
835                 /* calc maximum prebuff */
836                 prebuff_max = (device->prebuf * device->fraglen);
837                 if (!device->hwbuf && playpos + prebuff_max >= device->helfrags * device->fraglen)
838                         prebuff_max += device->buflen - device->helfrags * device->fraglen;
839
840                 /* check how close we are to an underrun. It occurs when the writepos overtakes the mixpos */
841                 prebuff_left = DSOUND_BufPtrDiff(device->buflen, device->mixpos, playpos);
842                 writelead = DSOUND_BufPtrDiff(device->buflen, writepos, playpos);
843
844                 /* check for underrun. underrun occurs when the write position passes the mix position
845                  * also wipe out just-played sound data */
846                 if((prebuff_left > prebuff_max) || (device->state == STATE_STOPPED) || (device->state == STATE_STARTING)){
847                         if (device->state == STATE_STOPPING || device->state == STATE_PLAYING)
848                                 WARN("Probable buffer underrun\n");
849                         else TRACE("Buffer starting or buffer underrun\n");
850
851                         /* recover mixing for all buffers */
852                         recover = TRUE;
853
854                         /* reset mix position to write position */
855                         device->mixpos = writepos;
856
857                         ZeroMemory(device->mix_buffer, device->mix_buffer_len);
858                         ZeroMemory(device->buffer, device->buflen);
859                 } else if (playpos < device->playpos) {
860                         buf1 = device->buffer + device->playpos;
861                         buf2 = device->buffer;
862                         size1 = device->buflen - device->playpos;
863                         size2 = playpos;
864                         FillMemory(device->mix_buffer + mixplaypos, device->mix_buffer_len - mixplaypos, 0);
865                         FillMemory(device->mix_buffer, mixplaypos2, 0);
866                         if (lock)
867                                 IDsDriverBuffer_Lock(device->hwbuf, &buf1, &size1, &buf2, &size2, device->playpos, size1+size2, 0);
868                         FillMemory(buf1, size1, nfiller);
869                         if (playpos && (!buf2 || !size2))
870                                 FIXME("%d: (%d, %d)=>(%d, %d) There should be an additional buffer here!!\n", __LINE__, device->playpos, device->mixpos, playpos, writepos);
871                         FillMemory(buf2, size2, nfiller);
872                         if (lock)
873                                 IDsDriverBuffer_Unlock(device->hwbuf, buf1, size1, buf2, size2);
874                 } else {
875                         buf1 = device->buffer + device->playpos;
876                         buf2 = NULL;
877                         size1 = playpos - device->playpos;
878                         size2 = 0;
879                         FillMemory(device->mix_buffer + mixplaypos, mixplaypos2 - mixplaypos, 0);
880                         if (lock)
881                                 IDsDriverBuffer_Lock(device->hwbuf, &buf1, &size1, &buf2, &size2, device->playpos, size1+size2, 0);
882                         FillMemory(buf1, size1, nfiller);
883                         if (buf2 && size2)
884                         {
885                                 FIXME("%d: There should be no additional buffer here!!\n", __LINE__);
886                                 FillMemory(buf2, size2, nfiller);
887                         }
888                         if (lock)
889                                 IDsDriverBuffer_Unlock(device->hwbuf, buf1, size1, buf2, size2);
890                 }
891                 device->playpos = playpos;
892
893                 /* find the maximum we can prebuffer from current write position */
894                 maxq = (writelead < prebuff_max) ? (prebuff_max - writelead) : 0;
895
896                 TRACE("prebuff_left = %d, prebuff_max = %dx%d=%d, writelead=%d\n",
897                         prebuff_left, device->prebuf, device->fraglen, prebuff_max, writelead);
898
899                 if (lock)
900                         IDsDriverBuffer_Lock(device->hwbuf, &buf1, &size1, &buf2, &size2, writepos, maxq, 0);
901
902                 /* do the mixing */
903                 frag = DSOUND_MixToPrimary(device, writepos, maxq, recover, &all_stopped);
904
905                 if (frag + writepos > device->buflen)
906                 {
907                         DWORD todo = device->buflen - writepos;
908                         device->normfunction(device->mix_buffer + DSOUND_bufpos_to_mixpos(device, writepos), device->buffer + writepos, todo);
909                         device->normfunction(device->mix_buffer, device->buffer, frag - todo);
910                 }
911                 else
912                         device->normfunction(device->mix_buffer + DSOUND_bufpos_to_mixpos(device, writepos), device->buffer + writepos, frag);
913
914                 /* update the mix position, taking wrap-around into account */
915                 device->mixpos = writepos + frag;
916                 device->mixpos %= device->buflen;
917
918                 if (lock)
919                 {
920                         DWORD frag2 = (frag > size1 ? frag - size1 : 0);
921                         frag -= frag2;
922                         if (frag2 > size2)
923                         {
924                                 FIXME("Buffering too much! (%d, %d, %d, %d)\n", maxq, frag, size2, frag2 - size2);
925                                 frag2 = size2;
926                         }
927                         IDsDriverBuffer_Unlock(device->hwbuf, buf1, frag, buf2, frag2);
928                 }
929
930                 /* update prebuff left */
931                 prebuff_left = DSOUND_BufPtrDiff(device->buflen, device->mixpos, playpos);
932
933                 /* check if have a whole fragment */
934                 if (prebuff_left >= device->fraglen){
935
936                         /* update the wave queue if using wave system */
937                         if (!device->hwbuf)
938                                 DSOUND_WaveQueue(device, FALSE);
939
940                         /* buffers are full. start playing if applicable */
941                         if(device->state == STATE_STARTING){
942                                 TRACE("started primary buffer\n");
943                                 if(DSOUND_PrimaryPlay(device) != DS_OK){
944                                         WARN("DSOUND_PrimaryPlay failed\n");
945                                 }
946                                 else{
947                                         /* we are playing now */
948                                         device->state = STATE_PLAYING;
949                                 }
950                         }
951
952                         /* buffers are full. start stopping if applicable */
953                         if(device->state == STATE_STOPPED){
954                                 TRACE("restarting primary buffer\n");
955                                 if(DSOUND_PrimaryPlay(device) != DS_OK){
956                                         WARN("DSOUND_PrimaryPlay failed\n");
957                                 }
958                                 else{
959                                         /* start stopping again. as soon as there is no more data, it will stop */
960                                         device->state = STATE_STOPPING;
961                                 }
962                         }
963                 }
964
965                 /* if device was stopping, its for sure stopped when all buffers have stopped */
966                 else if((all_stopped == TRUE) && (device->state == STATE_STOPPING)){
967                         TRACE("All buffers have stopped. Stopping primary buffer\n");
968                         device->state = STATE_STOPPED;
969
970                         /* stop the primary buffer now */
971                         DSOUND_PrimaryStop(device);
972                 }
973
974         } else {
975
976                 /* update the wave queue if using wave system */
977                 if (!device->hwbuf)
978                         DSOUND_WaveQueue(device, TRUE);
979                 else
980                         /* Keep alsa happy, which needs GetPosition called once every 10 ms */
981                         IDsDriverBuffer_GetPosition(device->hwbuf, NULL, NULL);
982
983                 /* in the DSSCL_WRITEPRIMARY mode, the app is totally in charge... */
984                 if (device->state == STATE_STARTING) {
985                         if (DSOUND_PrimaryPlay(device) != DS_OK)
986                                 WARN("DSOUND_PrimaryPlay failed\n");
987                         else
988                                 device->state = STATE_PLAYING;
989                 }
990                 else if (device->state == STATE_STOPPING) {
991                         if (DSOUND_PrimaryStop(device) != DS_OK)
992                                 WARN("DSOUND_PrimaryStop failed\n");
993                         else
994                                 device->state = STATE_STOPPED;
995                 }
996         }
997
998         LeaveCriticalSection(&(device->mixlock));
999         /* **** */
1000 }
1001
1002 void CALLBACK DSOUND_timer(UINT timerID, UINT msg, DWORD_PTR dwUser,
1003                            DWORD_PTR dw1, DWORD_PTR dw2)
1004 {
1005         DirectSoundDevice * device = (DirectSoundDevice*)dwUser;
1006         DWORD start_time =  GetTickCount();
1007         DWORD end_time;
1008         TRACE("(%d,%d,0x%lx,0x%lx,0x%lx)\n",timerID,msg,dwUser,dw1,dw2);
1009         TRACE("entering at %d\n", start_time);
1010
1011         if (DSOUND_renderer[device->drvdesc.dnDevNode] != device) {
1012                 ERR("dsound died without killing us?\n");
1013                 timeKillEvent(timerID);
1014                 timeEndPeriod(DS_TIME_RES);
1015                 return;
1016         }
1017
1018         RtlAcquireResourceShared(&(device->buffer_list_lock), TRUE);
1019
1020         if (device->ref)
1021                 DSOUND_PerformMix(device);
1022
1023         RtlReleaseResource(&(device->buffer_list_lock));
1024
1025         end_time = GetTickCount();
1026         TRACE("completed processing at %d, duration = %d\n", end_time, end_time - start_time);
1027 }
1028
1029 void CALLBACK DSOUND_callback(HWAVEOUT hwo, UINT msg, DWORD_PTR dwUser, DWORD_PTR dw1, DWORD_PTR dw2)
1030 {
1031         DirectSoundDevice * device = (DirectSoundDevice*)dwUser;
1032         TRACE("(%p,%x,%lx,%lx,%lx)\n",hwo,msg,dwUser,dw1,dw2);
1033         TRACE("entering at %d, msg=%08x(%s)\n", GetTickCount(), msg,
1034                 msg==MM_WOM_DONE ? "MM_WOM_DONE" : msg==MM_WOM_CLOSE ? "MM_WOM_CLOSE" : 
1035                 msg==MM_WOM_OPEN ? "MM_WOM_OPEN" : "UNKNOWN");
1036
1037         /* check if packet completed from wave driver */
1038         if (msg == MM_WOM_DONE) {
1039
1040                 /* **** */
1041                 EnterCriticalSection(&(device->mixlock));
1042
1043                 TRACE("done playing primary pos=%d\n", device->pwplay * device->fraglen);
1044
1045                 /* update playpos */
1046                 device->pwplay++;
1047                 device->pwplay %= device->helfrags;
1048
1049                 /* sanity */
1050                 if(device->pwqueue == 0){
1051                         ERR("Wave queue corrupted!\n");
1052                 }
1053
1054                 /* update queue */
1055                 device->pwqueue--;
1056
1057                 LeaveCriticalSection(&(device->mixlock));
1058                 /* **** */
1059         }
1060         TRACE("completed\n");
1061 }