git.sesse.net Git - vlc/blob - src/win32/thread.c

   1 /*****************************************************************************
   2  * thread.c : Win32 back-end for LibVLC
   3  *****************************************************************************
   4  * Copyright (C) 1999-2009 the VideoLAN team
   5  *
   6  * Authors: Jean-Marc Dressler <polux@via.ecp.fr>
   7  *          Samuel Hocevar <sam@zoy.org>
   8  *          Gildas Bazin <gbazin@netcourrier.com>
   9  *          Clément Sténac
  10  *          Rémi Denis-Courmont
  11  *          Pierre Ynard
  12  *
  13  * This program is free software; you can redistribute it and/or modify
  14  * it under the terms of the GNU General Public License as published by
  15  * the Free Software Foundation; either version 2 of the License, or
  16  * (at your option) any later version.
  17  *
  18  * This program is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU General Public License for more details.
  22  *
  23  * You should have received a copy of the GNU General Public License
  24  * along with this program; if not, write to the Free Software
  25  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  26  *****************************************************************************/
  27
  28 #ifdef HAVE_CONFIG_H
  29 # include "config.h"
  30 #endif
  31
  32 #include <vlc_common.h>
  33
  34 #include "libvlc.h"
  35 #include <stdarg.h>
  36 #include <assert.h>
  37 #include <limits.h>
  38 #include <errno.h>
  39 #ifdef UNDER_CE
  40 # include <mmsystem.h>
  41 #endif
  42
  43 static vlc_threadvar_t thread_key;
  44
  45 /**
  46  * Per-thread data
  47  */
  48 struct vlc_thread
  49 {
  50     HANDLE         id;
  51 #ifdef UNDER_CE
  52     HANDLE         cancel_event;
  53 #endif
  54
  55     bool           detached;
  56     bool           killable;
  57     bool           killed;
  58     vlc_cleanup_t *cleaners;
  59
  60     void        *(*entry) (void *);
  61     void          *data;
  62 };
  63
  64 #ifdef UNDER_CE
  65 static void CALLBACK vlc_cancel_self (ULONG_PTR dummy);
  66
  67 static DWORD vlc_cancelable_wait (DWORD count, const HANDLE *handles,
  68                                   DWORD delay)
  69 {
  70     struct vlc_thread *th = vlc_threadvar_get (thread_key);
  71     if (th == NULL)
  72     {
  73         /* Main thread - cannot be cancelled anyway */
  74         return WaitForMultipleObjects (count, handles, FALSE, delay);
  75     }
  76     HANDLE new_handles[count + 1];
  77     memcpy(new_handles, handles, count * sizeof(HANDLE));
  78     new_handles[count] = th->cancel_event;
  79     DWORD result = WaitForMultipleObjects (count + 1, new_handles, FALSE,
  80                                            delay);
  81     if (result == WAIT_OBJECT_0 + count)
  82     {
  83         vlc_cancel_self ((uintptr_t)th);
  84         return WAIT_IO_COMPLETION;
  85     }
  86     else
  87     {
  88         return result;
  89     }
  90 }
  91
  92 DWORD SleepEx (DWORD dwMilliseconds, BOOL bAlertable)
  93 {
  94     if (bAlertable)
  95     {
  96         DWORD result = vlc_cancelable_wait (0, NULL, dwMilliseconds);
  97         return (result == WAIT_TIMEOUT) ? 0 : WAIT_IO_COMPLETION;
  98     }
  99     else
 100     {
 101         Sleep(dwMilliseconds);
 102         return 0;
 103     }
 104 }
 105
 106 DWORD WaitForSingleObjectEx (HANDLE hHandle, DWORD dwMilliseconds,
 107                              BOOL bAlertable)
 108 {
 109     if (bAlertable)
 110     {
 111         /* The MSDN documentation specifies different return codes,
 112          * but in practice they are the same. We just check that it
 113          * remains so. */
 114 #if WAIT_ABANDONED != WAIT_ABANDONED_0
 115 # error Windows headers changed, code needs to be rewritten!
 116 #endif
 117         return vlc_cancelable_wait (1, &hHandle, dwMilliseconds);
 118     }
 119     else
 120     {
 121         return WaitForSingleObject (hHandle, dwMilliseconds);
 122     }
 123 }
 124
 125 DWORD WaitForMultipleObjectsEx (DWORD nCount, const HANDLE *lpHandles,
 126                                 BOOL bWaitAll, DWORD dwMilliseconds,
 127                                 BOOL bAlertable)
 128 {
 129     if (bAlertable)
 130     {
 131         /* We do not support the bWaitAll case */
 132         assert (! bWaitAll);
 133         return vlc_cancelable_wait (nCount, lpHandles, dwMilliseconds);
 134     }
 135     else
 136     {
 137         return WaitForMultipleObjects (nCount, lpHandles, bWaitAll,
 138                                        dwMilliseconds);
 139     }
 140 }
 141 #endif
 142
 143 vlc_mutex_t super_mutex;
 144 vlc_cond_t  super_variable;
 145
 146 BOOL WINAPI DllMain (HINSTANCE hinstDll, DWORD fdwReason, LPVOID lpvReserved)
 147 {
 148     (void) hinstDll;
 149     (void) lpvReserved;
 150
 151     switch (fdwReason)
 152     {
 153         case DLL_PROCESS_ATTACH:
 154             vlc_mutex_init (&super_mutex);
 155             vlc_cond_init (&super_variable);
 156             vlc_threadvar_create (&thread_key, NULL);
 157             break;
 158
 159         case DLL_PROCESS_DETACH:
 160             vlc_threadvar_delete (&thread_key);
 161             vlc_cond_destroy (&super_variable);
 162             vlc_mutex_destroy (&super_mutex);
 163             break;
 164     }
 165     return TRUE;
 166 }
 167
 168 /*** Mutexes ***/
 169 void vlc_mutex_init( vlc_mutex_t *p_mutex )
 170 {
 171     /* This creates a recursive mutex. This is OK as fast mutexes have
 172      * no defined behavior in case of recursive locking. */
 173     InitializeCriticalSection (&p_mutex->mutex);
 174     p_mutex->dynamic = true;
 175 }
 176
 177 void vlc_mutex_init_recursive( vlc_mutex_t *p_mutex )
 178 {
 179     InitializeCriticalSection( &p_mutex->mutex );
 180     p_mutex->dynamic = true;
 181 }
 182
 183
 184 void vlc_mutex_destroy (vlc_mutex_t *p_mutex)
 185 {
 186     assert (p_mutex->dynamic);
 187     DeleteCriticalSection (&p_mutex->mutex);
 188 }
 189
 190 void vlc_mutex_lock (vlc_mutex_t *p_mutex)
 191 {
 192     if (!p_mutex->dynamic)
 193     {   /* static mutexes */
 194         int canc = vlc_savecancel ();
 195         assert (p_mutex != &super_mutex); /* this one cannot be static */
 196
 197         vlc_mutex_lock (&super_mutex);
 198         while (p_mutex->locked)
 199         {
 200             p_mutex->contention++;
 201             vlc_cond_wait (&super_variable, &super_mutex);
 202             p_mutex->contention--;
 203         }
 204         p_mutex->locked = true;
 205         vlc_mutex_unlock (&super_mutex);
 206         vlc_restorecancel (canc);
 207         return;
 208     }
 209
 210     EnterCriticalSection (&p_mutex->mutex);
 211 }
 212
 213 int vlc_mutex_trylock (vlc_mutex_t *p_mutex)
 214 {
 215     if (!p_mutex->dynamic)
 216     {   /* static mutexes */
 217         int ret = EBUSY;
 218
 219         assert (p_mutex != &super_mutex); /* this one cannot be static */
 220         vlc_mutex_lock (&super_mutex);
 221         if (!p_mutex->locked)
 222         {
 223             p_mutex->locked = true;
 224             ret = 0;
 225         }
 226         vlc_mutex_unlock (&super_mutex);
 227         return ret;
 228     }
 229
 230     return TryEnterCriticalSection (&p_mutex->mutex) ? 0 : EBUSY;
 231 }
 232
 233 void vlc_mutex_unlock (vlc_mutex_t *p_mutex)
 234 {
 235     if (!p_mutex->dynamic)
 236     {   /* static mutexes */
 237         assert (p_mutex != &super_mutex); /* this one cannot be static */
 238
 239         vlc_mutex_lock (&super_mutex);
 240         assert (p_mutex->locked);
 241         p_mutex->locked = false;
 242         if (p_mutex->contention)
 243             vlc_cond_broadcast (&super_variable);
 244         vlc_mutex_unlock (&super_mutex);
 245         return;
 246     }
 247
 248     LeaveCriticalSection (&p_mutex->mutex);
 249 }
 250
 251 /*** Condition variables ***/
 252 enum
 253 {
 254     CLOCK_MONOTONIC,
 255     CLOCK_REALTIME,
 256 };
 257
 258 static void vlc_cond_init_common (vlc_cond_t *p_condvar, unsigned clock)
 259 {
 260     /* Create a manual-reset event (manual reset is needed for broadcast). */
 261     p_condvar->handle = CreateEvent (NULL, TRUE, FALSE, NULL);
 262     if (!p_condvar->handle)
 263         abort();
 264     p_condvar->clock = clock;
 265 }
 266
 267 void vlc_cond_init (vlc_cond_t *p_condvar)
 268 {
 269     vlc_cond_init_common (p_condvar, CLOCK_MONOTONIC);
 270 }
 271
 272 void vlc_cond_init_daytime (vlc_cond_t *p_condvar)
 273 {
 274     vlc_cond_init_common (p_condvar, CLOCK_REALTIME);
 275 }
 276
 277 void vlc_cond_destroy (vlc_cond_t *p_condvar)
 278 {
 279     CloseHandle (p_condvar->handle);
 280 }
 281
 282 void vlc_cond_signal (vlc_cond_t *p_condvar)
 283 {
 284     /* NOTE: This will cause a broadcast, that is wrong.
 285      * This will also wake up the next waiting thread if no threads are yet
 286      * waiting, which is also wrong. However both of these issues are allowed
 287      * by the provision for spurious wakeups. Better have too many wakeups
 288      * than too few (= deadlocks). */
 289     SetEvent (p_condvar->handle);
 290 }
 291
 292 void vlc_cond_broadcast (vlc_cond_t *p_condvar)
 293 {
 294     SetEvent (p_condvar->handle);
 295 }
 296
 297 void vlc_cond_wait (vlc_cond_t *p_condvar, vlc_mutex_t *p_mutex)
 298 {
 299     DWORD result;
 300
 301     assert (p_mutex->dynamic); /* TODO */
 302     do
 303     {
 304         vlc_testcancel ();
 305         LeaveCriticalSection (&p_mutex->mutex);
 306         result = WaitForSingleObjectEx (p_condvar->handle, INFINITE, TRUE);
 307         EnterCriticalSection (&p_mutex->mutex);
 308     }
 309     while (result == WAIT_IO_COMPLETION);
 310
 311     assert (result != WAIT_ABANDONED); /* another thread failed to cleanup! */
 312     assert (result != WAIT_FAILED);
 313     ResetEvent (p_condvar->handle);
 314 }
 315
 316 int vlc_cond_timedwait (vlc_cond_t *p_condvar, vlc_mutex_t *p_mutex,
 317                         mtime_t deadline)
 318 {
 319     DWORD result;
 320
 321     assert (p_mutex->dynamic); /* TODO */
 322     do
 323     {
 324         vlc_testcancel ();
 325
 326         mtime_t total;
 327         switch (p_condvar->clock)
 328         {
 329             case CLOCK_MONOTONIC:
 330                 total = mdate();
 331                 break;
 332             case CLOCK_REALTIME: /* FIXME? sub-second precision */
 333                 total = CLOCK_FREQ * time (NULL);
 334                 break;
 335             default:
 336                 assert (0);
 337         }
 338         total = (deadline - total) / 1000;
 339         if( total < 0 )
 340             total = 0;
 341
 342         DWORD delay = (total > 0x7fffffff) ? 0x7fffffff : total;
 343         LeaveCriticalSection (&p_mutex->mutex);
 344         result = WaitForSingleObjectEx (p_condvar->handle, delay, TRUE);
 345         EnterCriticalSection (&p_mutex->mutex);
 346     }
 347     while (result == WAIT_IO_COMPLETION);
 348
 349     assert (result != WAIT_ABANDONED);
 350     assert (result != WAIT_FAILED);
 351     ResetEvent (p_condvar->handle);
 352
 353     return (result == WAIT_OBJECT_0) ? 0 : ETIMEDOUT;
 354 }
 355
 356 /*** Semaphore ***/
 357 void vlc_sem_init (vlc_sem_t *sem, unsigned value)
 358 {
 359     *sem = CreateSemaphore (NULL, value, 0x7fffffff, NULL);
 360     if (*sem == NULL)
 361         abort ();
 362 }
 363
 364 void vlc_sem_destroy (vlc_sem_t *sem)
 365 {
 366     CloseHandle (*sem);
 367 }
 368
 369 int vlc_sem_post (vlc_sem_t *sem)
 370 {
 371     ReleaseSemaphore (*sem, 1, NULL);
 372     return 0; /* FIXME */
 373 }
 374
 375 void vlc_sem_wait (vlc_sem_t *sem)
 376 {
 377     DWORD result;
 378
 379     do
 380     {
 381         vlc_testcancel ();
 382         result = WaitForSingleObjectEx (*sem, INFINITE, TRUE);
 383     }
 384     while (result == WAIT_IO_COMPLETION);
 385 }
 386
 387 /*** Read/write locks */
 388 /* SRW (Slim Read Write) locks are available in Vista+ only */
 389 void vlc_rwlock_init (vlc_rwlock_t *lock)
 390 {
 391     vlc_mutex_init (&lock->mutex);
 392     vlc_cond_init (&lock->read_wait);
 393     vlc_cond_init (&lock->write_wait);
 394     lock->readers = 0; /* active readers */
 395     lock->writers = 0; /* waiting or active writers */
 396     lock->writer = 0; /* ID of active writer */
 397 }
 398
 399 /**
 400  * Destroys an initialized unused read/write lock.
 401  */
 402 void vlc_rwlock_destroy (vlc_rwlock_t *lock)
 403 {
 404     vlc_cond_destroy (&lock->read_wait);
 405     vlc_cond_destroy (&lock->write_wait);
 406     vlc_mutex_destroy (&lock->mutex);
 407 }
 408
 409 /**
 410  * Acquires a read/write lock for reading. Recursion is allowed.
 411  */
 412 void vlc_rwlock_rdlock (vlc_rwlock_t *lock)
 413 {
 414     vlc_mutex_lock (&lock->mutex);
 415     while (lock->writer != 0)
 416         vlc_cond_wait (&lock->read_wait, &lock->mutex);
 417     if (lock->readers == ULONG_MAX)
 418         abort ();
 419     lock->readers++;
 420     vlc_mutex_unlock (&lock->mutex);
 421 }
 422
 423 /**
 424  * Acquires a read/write lock for writing. Recursion is not allowed.
 425  */
 426 void vlc_rwlock_wrlock (vlc_rwlock_t *lock)
 427 {
 428     vlc_mutex_lock (&lock->mutex);
 429     if (lock->writers == ULONG_MAX)
 430         abort ();
 431     lock->writers++;
 432     while ((lock->readers > 0) || (lock->writer != 0))
 433         vlc_cond_wait (&lock->write_wait, &lock->mutex);
 434     lock->writers--;
 435     lock->writer = GetCurrentThreadId ();
 436     vlc_mutex_unlock (&lock->mutex);
 437 }
 438
 439 /**
 440  * Releases a read/write lock.
 441  */
 442 void vlc_rwlock_unlock (vlc_rwlock_t *lock)
 443 {
 444     vlc_mutex_lock (&lock->mutex);
 445     if (lock->readers > 0)
 446         lock->readers--; /* Read unlock */
 447     else
 448         lock->writer = 0; /* Write unlock */
 449
 450     if (lock->writers > 0)
 451     {
 452         if (lock->readers == 0)
 453             vlc_cond_signal (&lock->write_wait);
 454     }
 455     else
 456         vlc_cond_broadcast (&lock->read_wait);
 457     vlc_mutex_unlock (&lock->mutex);
 458 }
 459
 460 /*** Thread-specific variables (TLS) ***/
 461 struct vlc_threadvar
 462 {
 463     DWORD                 id;
 464     void                (*destroy) (void *);
 465     struct vlc_threadvar *prev;
 466     struct vlc_threadvar *next;
 467 } *vlc_threadvar_last = NULL;
 468
 469 int vlc_threadvar_create (vlc_threadvar_t *p_tls, void (*destr) (void *))
 470 {
 471     struct vlc_threadvar *var = malloc (sizeof (*var));
 472     if (unlikely(var == NULL))
 473         return errno;
 474
 475     var->id = TlsAlloc();
 476     if (var->id == TLS_OUT_OF_INDEXES)
 477     {
 478         free (var);
 479         return EAGAIN;
 480     }
 481     var->destroy = destr;
 482     var->next = NULL;
 483     *p_tls = var;
 484
 485     vlc_mutex_lock (&super_mutex);
 486     var->prev = vlc_threadvar_last;
 487     vlc_threadvar_last = var;
 488     vlc_mutex_unlock (&super_mutex);
 489     return 0;
 490 }
 491
 492 void vlc_threadvar_delete (vlc_threadvar_t *p_tls)
 493 {
 494     struct vlc_threadvar *var = *p_tls;
 495
 496     vlc_mutex_lock (&super_mutex);
 497     if (var->prev != NULL)
 498         var->prev->next = var->next;
 499     else
 500         vlc_threadvar_last = var->next;
 501     if (var->next != NULL)
 502         var->next->prev = var->prev;
 503     vlc_mutex_unlock (&super_mutex);
 504
 505     TlsFree (var->id);
 506     free (var);
 507 }
 508
 509 int vlc_threadvar_set (vlc_threadvar_t key, void *value)
 510 {
 511     return TlsSetValue (key->id, value) ? ENOMEM : 0;
 512 }
 513
 514 void *vlc_threadvar_get (vlc_threadvar_t key)
 515 {
 516     return TlsGetValue (key->id);
 517 }
 518
 519 static void vlc_threadvar_cleanup (void)
 520 {
 521     vlc_threadvar_t key;
 522
 523 retry:
 524     /* TODO: use RW lock or something similar */
 525     vlc_mutex_lock (&super_mutex);
 526     for (key = vlc_threadvar_last; key != NULL; key = key->prev)
 527     {
 528         void *value = vlc_threadvar_get (key);
 529         if (value != NULL && key->destroy != NULL)
 530         {
 531             vlc_mutex_unlock (&super_mutex);
 532             vlc_threadvar_set (key, NULL);
 533             key->destroy (value);
 534             goto retry;
 535         }
 536     }
 537     vlc_mutex_unlock (&super_mutex);
 538 }
 539
 540
 541 /*** Threads ***/
 542 void vlc_threads_setup (libvlc_int_t *p_libvlc)
 543 {
 544     (void) p_libvlc;
 545 }
 546
 547 static unsigned __stdcall vlc_entry (void *p)
 548 {
 549     struct vlc_thread *th = p;
 550
 551     vlc_threadvar_set (thread_key, th);
 552     th->killable = true;
 553     th->data = th->entry (th->data);
 554     vlc_threadvar_cleanup ();
 555     if (th->detached)
 556         free (th);
 557     return 0;
 558 }
 559
 560 int vlc_clone (vlc_thread_t *p_handle, void * (*entry) (void *), void *data,
 561                int priority)
 562 {
 563     struct vlc_thread *th = malloc (sizeof (*th));
 564     if (unlikely(th == NULL))
 565         return ENOMEM;
 566     th->entry = entry;
 567     th->data = data;
 568     th->detached = p_handle == NULL;
 569     th->killable = false; /* not until vlc_entry() ! */
 570     th->killed = false;
 571     th->cleaners = NULL;
 572
 573     HANDLE hThread;
 574 #ifndef UNDER_CE
 575     /* When using the MSVCRT C library you have to use the _beginthreadex
 576      * function instead of CreateThread, otherwise you'll end up with
 577      * memory leaks and the signal functions not working (see Microsoft
 578      * Knowledge Base, article 104641) */
 579     hThread = (HANDLE)(uintptr_t)
 580         _beginthreadex (NULL, 0, vlc_entry, th, CREATE_SUSPENDED, NULL);
 581     if (hThread == NULL)
 582     {
 583         int err = errno;
 584         free (th);
 585         return err;
 586     }
 587
 588 #else
 589     /* FIXME: cancel_event is useless and leaked in detached threads */
 590     th->cancel_event = CreateEvent (NULL, FALSE, FALSE, NULL);
 591     if (th->cancel_event == NULL)
 592     {
 593         free (th);
 594         return ENOMEM;
 595     }
 596
 597     /* Not sure if CREATE_SUSPENDED + ResumeThread() is any useful on WinCE.
 598      * Thread handles act up, too. */
 599     hThread = CreateThread (NULL, 128*1024, vlc_entry, th,
 600                             CREATE_SUSPENDED, NULL);
 601     if (hThread == NULL)
 602     {
 603         CloseHandle (th->cancel_event);
 604         free (th);
 605         return ENOMEM;
 606     }
 607
 608 #endif
 609     th->id = hThread;
 610
 611     ResumeThread (hThread);
 612     if (priority)
 613         SetThreadPriority (hThread, priority);
 614
 615     if (p_handle != NULL)
 616         *p_handle = th;
 617     else
 618         CloseHandle (hThread);
 619
 620     return 0;
 621 }
 622
 623 void vlc_join (vlc_thread_t th, void **result)
 624 {
 625     do
 626         vlc_testcancel ();
 627     while (WaitForSingleObjectEx (th->id, INFINITE, TRUE)
 628                                                         == WAIT_IO_COMPLETION);
 629
 630     CloseHandle (th->id);
 631 #ifdef UNDER_CE
 632     CloseHandle (th->cancel_event);
 633 #endif
 634     if (result != NULL)
 635         *result = th->data;
 636     free (th);
 637 }
 638
 639 int vlc_clone_detach (void *(*entry) (void *), void *data, int priority)
 640 {
 641     return vlc_clone (NULL, entry, data, priority);
 642 }
 643
 644 /*** Thread cancellation ***/
 645
 646 /* APC procedure for thread cancellation */
 647 static void CALLBACK vlc_cancel_self (ULONG_PTR self)
 648 {
 649     struct vlc_thread *th = (void *)self;
 650
 651     if (likely(th != NULL))
 652         th->killed = true;
 653 }
 654
 655 void vlc_cancel (vlc_thread_t th)
 656 {
 657 #ifndef UNDER_CE
 658     QueueUserAPC (vlc_cancel_self, th->id, (uintptr_t)th);
 659 #else
 660     SetEvent (th->cancel_event);
 661 #endif
 662 }
 663
 664 int vlc_savecancel (void)
 665 {
 666     struct vlc_thread *th = vlc_threadvar_get (thread_key);
 667     if (th == NULL)
 668         return false; /* Main thread - cannot be cancelled anyway */
 669
 670     int state = th->killable;
 671     th->killable = false;
 672     return state;
 673 }
 674
 675 void vlc_restorecancel (int state)
 676 {
 677     struct vlc_thread *th = vlc_threadvar_get (thread_key);
 678     assert (state == false || state == true);
 679
 680     if (th == NULL)
 681         return; /* Main thread - cannot be cancelled anyway */
 682
 683     assert (!th->killable);
 684     th->killable = state != 0;
 685 }
 686
 687 void vlc_testcancel (void)
 688 {
 689     struct vlc_thread *th = vlc_threadvar_get (thread_key);
 690     if (th == NULL)
 691         return; /* Main thread - cannot be cancelled anyway */
 692
 693     if (th->killable && th->killed)
 694     {
 695         /* Detached threads cannot be cancelled */
 696         assert (!th->detached);
 697
 698         th->data = NULL; /* TODO: special value? */
 699
 700         for (vlc_cleanup_t *p = th->cleaners; p != NULL; p = p->next)
 701              p->proc (p->data);
 702         vlc_threadvar_cleanup ();
 703 #ifndef UNDER_CE
 704         _endthreadex(0);
 705 #else
 706         ExitThread(0);
 707 #endif
 708     }
 709 }
 710
 711 void vlc_control_cancel (int cmd, ...)
 712 {
 713     /* NOTE: This function only modifies thread-specific data, so there is no
 714      * need to lock anything. */
 715     va_list ap;
 716
 717     struct vlc_thread *th = vlc_threadvar_get (thread_key);
 718     if (th == NULL)
 719         return; /* Main thread - cannot be cancelled anyway */
 720
 721     va_start (ap, cmd);
 722     switch (cmd)
 723     {
 724         case VLC_CLEANUP_PUSH:
 725         {
 726             /* cleaner is a pointer to the caller stack, no need to allocate
 727              * and copy anything. As a nice side effect, this cannot fail. */
 728             vlc_cleanup_t *cleaner = va_arg (ap, vlc_cleanup_t *);
 729             cleaner->next = th->cleaners;
 730             th->cleaners = cleaner;
 731             break;
 732         }
 733
 734         case VLC_CLEANUP_POP:
 735         {
 736             th->cleaners = th->cleaners->next;
 737             break;
 738         }
 739     }
 740     va_end (ap);
 741 }
 742
 743
 744 /*** Timers ***/
 745 struct vlc_timer
 746 {
 747 #ifndef UNDER_CE
 748     HANDLE handle;
 749 #else
 750     unsigned id;
 751     unsigned interval;
 752 #endif
 753     void (*func) (void *);
 754     void *data;
 755 };
 756
 757 #ifndef UNDER_CE
 758 static void CALLBACK vlc_timer_do (void *val, BOOLEAN timeout)
 759 {
 760     struct vlc_timer *timer = val;
 761
 762     assert (timeout);
 763     timer->func (timer->data);
 764 }
 765 #else
 766 static void CALLBACK vlc_timer_do (unsigned timer_id, unsigned msg,
 767                                    DWORD_PTR user, DWORD_PTR unused1,
 768                                    DWORD_PTR unused2)
 769 {
 770     struct vlc_timer *timer = (struct vlc_timer *) user;
 771     assert (timer_id == timer->id);
 772     (void) msg;
 773     (void) unused1;
 774     (void) unused2;
 775
 776     timer->func (timer->data);
 777
 778     if (timer->interval)
 779     {
 780         mtime_t interval = timer->interval * 1000;
 781         vlc_timer_schedule (timer, false, interval, interval);
 782     }
 783 }
 784 #endif
 785
 786 int vlc_timer_create (vlc_timer_t *id, void (*func) (void *), void *data)
 787 {
 788     struct vlc_timer *timer = malloc (sizeof (*timer));
 789
 790     if (timer == NULL)
 791         return ENOMEM;
 792     timer->func = func;
 793     timer->data = data;
 794 #ifndef UNDER_CE
 795     timer->handle = INVALID_HANDLE_VALUE;
 796 #else
 797     timer->id = 0;
 798     timer->interval = 0;
 799 #endif
 800     *id = timer;
 801     return 0;
 802 }
 803
 804 void vlc_timer_destroy (vlc_timer_t timer)
 805 {
 806 #ifndef UNDER_CE
 807     if (timer->handle != INVALID_HANDLE_VALUE)
 808         DeleteTimerQueueTimer (NULL, timer->handle, INVALID_HANDLE_VALUE);
 809 #else
 810     if (timer->id)
 811         timeKillEvent (timer->id);
 812     /* FIXME: timers that have not yet completed will trigger use-after-free */
 813 #endif
 814     free (timer);
 815 }
 816
 817 void vlc_timer_schedule (vlc_timer_t timer, bool absolute,
 818                          mtime_t value, mtime_t interval)
 819 {
 820 #ifndef UNDER_CE
 821     if (timer->handle != INVALID_HANDLE_VALUE)
 822     {
 823         DeleteTimerQueueTimer (NULL, timer->handle, NULL);
 824         timer->handle = INVALID_HANDLE_VALUE;
 825     }
 826 #else
 827     if (timer->id)
 828     {
 829         timeKillEvent (timer->id);
 830         timer->id = 0;
 831         timer->interval = 0;
 832     }
 833 #endif
 834     if (value == 0)
 835         return; /* Disarm */
 836
 837     if (absolute)
 838         value -= mdate ();
 839     value = (value + 999) / 1000;
 840     interval = (interval + 999) / 1000;
 841
 842 #ifndef UNDER_CE
 843     if (!CreateTimerQueueTimer (&timer->handle, NULL, vlc_timer_do, timer,
 844                                 value, interval, WT_EXECUTEDEFAULT))
 845 #else
 846     TIMECAPS caps;
 847     timeGetDevCaps (&caps, sizeof(caps));
 848
 849     unsigned delay = value;
 850     delay = __MAX(delay, caps.wPeriodMin);
 851     delay = __MIN(delay, caps.wPeriodMax);
 852
 853     unsigned event = TIME_ONESHOT;
 854
 855     if (interval == delay)
 856         event = TIME_PERIODIC;
 857     else if (interval)
 858         timer->interval = interval;
 859
 860     timer->id = timeSetEvent (delay, delay / 20, vlc_timer_do, (DWORD) timer,
 861                               event);
 862     if (!timer->id)
 863 #endif
 864         abort ();
 865 }
 866
 867 unsigned vlc_timer_getoverrun (vlc_timer_t timer)
 868 {
 869     (void)timer;
 870     return 0;
 871 }