1 /*****************************************************************************
2 * thread.c : Win32 back-end for LibVLC
3 *****************************************************************************
4 * Copyright (C) 1999-2009 VLC authors and VideoLAN
6 * Authors: Jean-Marc Dressler <polux@via.ecp.fr>
7 * Samuel Hocevar <sam@zoy.org>
8 * Gildas Bazin <gbazin@netcourrier.com>
13 * This program is free software; you can redistribute it and/or modify it
14 * under the terms of the GNU Lesser General Public License as published by
15 * the Free Software Foundation; either version 2.1 of the License, or
16 * (at your option) any later version.
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 Lesser General Public License for more details.
23 * You should have received a copy of the GNU Lesser General Public License
24 * along with this program; if not, write to the Free Software Foundation,
25 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
26 *****************************************************************************/
32 #include <vlc_common.h>
40 /*** Static mutex and condition variable ***/
41 static vlc_mutex_t super_mutex;
42 static vlc_cond_t super_variable;
45 /*** Common helpers ***/
46 static DWORD vlc_WaitForMultipleObjects (DWORD count, const HANDLE *handles,
52 ret = SleepEx (delay, TRUE);
57 ret = WaitForMultipleObjectsEx (count, handles, FALSE, delay, TRUE);
59 /* We do not abandon objects... this would be a bug */
60 assert (ret < WAIT_ABANDONED_0 || WAIT_ABANDONED_0 + count - 1 < ret);
62 if (unlikely(ret == WAIT_FAILED))
63 abort (); /* We are screwed! */
67 static DWORD vlc_WaitForSingleObject (HANDLE handle, DWORD delay)
69 return vlc_WaitForMultipleObjects (1, &handle, delay);
72 static DWORD vlc_Sleep (DWORD delay)
74 DWORD ret = vlc_WaitForMultipleObjects (0, NULL, delay);
75 return (ret != WAIT_TIMEOUT) ? ret : 0;
80 void vlc_mutex_init( vlc_mutex_t *p_mutex )
82 /* This creates a recursive mutex. This is OK as fast mutexes have
83 * no defined behavior in case of recursive locking. */
84 InitializeCriticalSection (&p_mutex->mutex);
85 p_mutex->dynamic = true;
88 void vlc_mutex_init_recursive( vlc_mutex_t *p_mutex )
90 InitializeCriticalSection( &p_mutex->mutex );
91 p_mutex->dynamic = true;
95 void vlc_mutex_destroy (vlc_mutex_t *p_mutex)
97 assert (p_mutex->dynamic);
98 DeleteCriticalSection (&p_mutex->mutex);
101 void vlc_mutex_lock (vlc_mutex_t *p_mutex)
103 if (!p_mutex->dynamic)
104 { /* static mutexes */
105 int canc = vlc_savecancel ();
106 assert (p_mutex != &super_mutex); /* this one cannot be static */
108 vlc_mutex_lock (&super_mutex);
109 while (p_mutex->locked)
111 p_mutex->contention++;
112 vlc_cond_wait (&super_variable, &super_mutex);
113 p_mutex->contention--;
115 p_mutex->locked = true;
116 vlc_mutex_unlock (&super_mutex);
117 vlc_restorecancel (canc);
121 EnterCriticalSection (&p_mutex->mutex);
124 int vlc_mutex_trylock (vlc_mutex_t *p_mutex)
126 if (!p_mutex->dynamic)
127 { /* static mutexes */
130 assert (p_mutex != &super_mutex); /* this one cannot be static */
131 vlc_mutex_lock (&super_mutex);
132 if (!p_mutex->locked)
134 p_mutex->locked = true;
137 vlc_mutex_unlock (&super_mutex);
141 return TryEnterCriticalSection (&p_mutex->mutex) ? 0 : EBUSY;
144 void vlc_mutex_unlock (vlc_mutex_t *p_mutex)
146 if (!p_mutex->dynamic)
147 { /* static mutexes */
148 assert (p_mutex != &super_mutex); /* this one cannot be static */
150 vlc_mutex_lock (&super_mutex);
151 assert (p_mutex->locked);
152 p_mutex->locked = false;
153 if (p_mutex->contention)
154 vlc_cond_broadcast (&super_variable);
155 vlc_mutex_unlock (&super_mutex);
159 LeaveCriticalSection (&p_mutex->mutex);
162 /*** Condition variables ***/
165 CLOCK_STATIC=0, /* must be zero for VLC_STATIC_COND */
170 static void vlc_cond_init_common (vlc_cond_t *p_condvar, unsigned clock)
172 /* Create a manual-reset event (manual reset is needed for broadcast). */
173 p_condvar->handle = CreateEvent (NULL, TRUE, FALSE, NULL);
174 if (!p_condvar->handle)
176 p_condvar->clock = clock;
179 void vlc_cond_init (vlc_cond_t *p_condvar)
181 vlc_cond_init_common (p_condvar, CLOCK_MONOTONIC);
184 void vlc_cond_init_daytime (vlc_cond_t *p_condvar)
186 vlc_cond_init_common (p_condvar, CLOCK_REALTIME);
189 void vlc_cond_destroy (vlc_cond_t *p_condvar)
191 CloseHandle (p_condvar->handle);
194 void vlc_cond_signal (vlc_cond_t *p_condvar)
196 if (!p_condvar->clock)
199 /* This is suboptimal but works. */
200 vlc_cond_broadcast (p_condvar);
203 void vlc_cond_broadcast (vlc_cond_t *p_condvar)
205 if (!p_condvar->clock)
208 /* Wake all threads up (as the event HANDLE has manual reset) */
209 SetEvent (p_condvar->handle);
212 void vlc_cond_wait (vlc_cond_t *p_condvar, vlc_mutex_t *p_mutex)
216 if (!p_condvar->clock)
217 { /* FIXME FIXME FIXME */
225 vlc_mutex_unlock (p_mutex);
226 result = vlc_WaitForSingleObject (p_condvar->handle, INFINITE);
227 vlc_mutex_lock (p_mutex);
229 while (result == WAIT_IO_COMPLETION);
231 ResetEvent (p_condvar->handle);
234 int vlc_cond_timedwait (vlc_cond_t *p_condvar, vlc_mutex_t *p_mutex,
244 switch (p_condvar->clock)
246 case CLOCK_MONOTONIC:
249 case CLOCK_REALTIME: /* FIXME? sub-second precision */
250 total = CLOCK_FREQ * time (NULL);
253 assert (!p_condvar->clock);
254 /* FIXME FIXME FIXME */
258 total = (deadline - total) / 1000;
262 DWORD delay = (total > 0x7fffffff) ? 0x7fffffff : total;
263 vlc_mutex_unlock (p_mutex);
264 result = vlc_WaitForSingleObject (p_condvar->handle, delay);
265 vlc_mutex_lock (p_mutex);
267 while (result == WAIT_IO_COMPLETION);
269 ResetEvent (p_condvar->handle);
271 return (result == WAIT_OBJECT_0) ? 0 : ETIMEDOUT;
275 void vlc_sem_init (vlc_sem_t *sem, unsigned value)
277 *sem = CreateSemaphore (NULL, value, 0x7fffffff, NULL);
282 void vlc_sem_destroy (vlc_sem_t *sem)
287 int vlc_sem_post (vlc_sem_t *sem)
289 ReleaseSemaphore (*sem, 1, NULL);
290 return 0; /* FIXME */
293 void vlc_sem_wait (vlc_sem_t *sem)
300 result = vlc_WaitForSingleObject (*sem, INFINITE);
302 while (result == WAIT_IO_COMPLETION);
305 /*** Thread-specific variables (TLS) ***/
309 void (*destroy) (void *);
310 struct vlc_threadvar *prev;
311 struct vlc_threadvar *next;
312 } *vlc_threadvar_last = NULL;
314 int vlc_threadvar_create (vlc_threadvar_t *p_tls, void (*destr) (void *))
316 struct vlc_threadvar *var = malloc (sizeof (*var));
317 if (unlikely(var == NULL))
320 var->id = TlsAlloc();
321 if (var->id == TLS_OUT_OF_INDEXES)
326 var->destroy = destr;
330 vlc_mutex_lock (&super_mutex);
331 var->prev = vlc_threadvar_last;
333 var->prev->next = var;
335 vlc_threadvar_last = var;
336 vlc_mutex_unlock (&super_mutex);
340 void vlc_threadvar_delete (vlc_threadvar_t *p_tls)
342 struct vlc_threadvar *var = *p_tls;
344 vlc_mutex_lock (&super_mutex);
345 if (var->prev != NULL)
346 var->prev->next = var->next;
348 if (var->next != NULL)
349 var->next->prev = var->prev;
351 vlc_threadvar_last = var->prev;
353 vlc_mutex_unlock (&super_mutex);
359 int vlc_threadvar_set (vlc_threadvar_t key, void *value)
361 return TlsSetValue (key->id, value) ? ENOMEM : 0;
364 void *vlc_threadvar_get (vlc_threadvar_t key)
366 return TlsGetValue (key->id);
370 static vlc_threadvar_t thread_key;
372 /** Per-thread data */
380 vlc_cleanup_t *cleaners;
382 void *(*entry) (void *);
386 static void vlc_thread_cleanup (struct vlc_thread *th)
391 /* TODO: use RW lock or something similar */
392 vlc_mutex_lock (&super_mutex);
393 for (key = vlc_threadvar_last; key != NULL; key = key->prev)
395 void *value = vlc_threadvar_get (key);
396 if (value != NULL && key->destroy != NULL)
398 vlc_mutex_unlock (&super_mutex);
399 vlc_threadvar_set (key, NULL);
400 key->destroy (value);
404 vlc_mutex_unlock (&super_mutex);
408 CloseHandle (th->id);
413 static unsigned __stdcall vlc_entry (void *p)
415 struct vlc_thread *th = p;
417 vlc_threadvar_set (thread_key, th);
419 th->data = th->entry (th->data);
420 vlc_thread_cleanup (th);
424 static int vlc_clone_attr (vlc_thread_t *p_handle, bool detached,
425 void *(*entry) (void *), void *data, int priority)
427 struct vlc_thread *th = malloc (sizeof (*th));
428 if (unlikely(th == NULL))
432 th->detached = detached;
433 th->killable = false; /* not until vlc_entry() ! */
438 /* When using the MSVCRT C library you have to use the _beginthreadex
439 * function instead of CreateThread, otherwise you'll end up with
440 * memory leaks and the signal functions not working (see Microsoft
441 * Knowledge Base, article 104641) */
444 h = _beginthreadex (NULL, 0, vlc_entry, th, CREATE_SUSPENDED, NULL);
453 /* Thread is suspended, so we can safely set th->id */
455 if (p_handle != NULL)
459 SetThreadPriority (hThread, priority);
461 ResumeThread (hThread);
466 int vlc_clone (vlc_thread_t *p_handle, void *(*entry) (void *),
467 void *data, int priority)
469 return vlc_clone_attr (p_handle, false, entry, data, priority);
472 void vlc_join (vlc_thread_t th, void **result)
476 while (vlc_WaitForSingleObject (th->id, INFINITE) == WAIT_IO_COMPLETION);
480 CloseHandle (th->id);
484 int vlc_clone_detach (vlc_thread_t *p_handle, void *(*entry) (void *),
485 void *data, int priority)
488 if (p_handle == NULL)
491 return vlc_clone_attr (p_handle, true, entry, data, priority);
494 int vlc_set_priority (vlc_thread_t th, int priority)
496 if (!SetThreadPriority (th->id, priority))
501 /*** Thread cancellation ***/
503 /* APC procedure for thread cancellation */
504 static void CALLBACK vlc_cancel_self (ULONG_PTR self)
506 struct vlc_thread *th = (void *)self;
508 if (likely(th != NULL))
512 void vlc_cancel (vlc_thread_t th)
514 QueueUserAPC (vlc_cancel_self, th->id, (uintptr_t)th);
517 int vlc_savecancel (void)
519 struct vlc_thread *th = vlc_threadvar_get (thread_key);
521 return false; /* Main thread - cannot be cancelled anyway */
523 int state = th->killable;
524 th->killable = false;
528 void vlc_restorecancel (int state)
530 struct vlc_thread *th = vlc_threadvar_get (thread_key);
531 assert (state == false || state == true);
534 return; /* Main thread - cannot be cancelled anyway */
536 assert (!th->killable);
537 th->killable = state != 0;
540 void vlc_testcancel (void)
542 struct vlc_thread *th = vlc_threadvar_get (thread_key);
544 return; /* Main thread - cannot be cancelled anyway */
546 if (th->killable && th->killed)
548 for (vlc_cleanup_t *p = th->cleaners; p != NULL; p = p->next)
551 th->data = NULL; /* TODO: special value? */
552 vlc_thread_cleanup (th);
557 void vlc_control_cancel (int cmd, ...)
559 /* NOTE: This function only modifies thread-specific data, so there is no
560 * need to lock anything. */
563 struct vlc_thread *th = vlc_threadvar_get (thread_key);
565 return; /* Main thread - cannot be cancelled anyway */
570 case VLC_CLEANUP_PUSH:
572 /* cleaner is a pointer to the caller stack, no need to allocate
573 * and copy anything. As a nice side effect, this cannot fail. */
574 vlc_cleanup_t *cleaner = va_arg (ap, vlc_cleanup_t *);
575 cleaner->next = th->cleaners;
576 th->cleaners = cleaner;
580 case VLC_CLEANUP_POP:
582 th->cleaners = th->cleaners->next;
590 static CRITICAL_SECTION clock_lock;
592 static mtime_t mdate_giveup (void)
597 static mtime_t (*mdate_selected) (void) = mdate_giveup;
601 return mdate_selected ();
608 #if (_WIN32_WINNT < 0x0601)
609 BOOL (*query) (PULONGLONG);
614 #if (_WIN32_WINNT < 0x0600)
615 ULONGLONG (*get) (void);
624 static mtime_t mdate_interrupt (void)
629 #if (_WIN32_WINNT >= 0x0601)
630 ret = QueryUnbiasedInterruptTime (&ts);
632 ret = clk.interrupt.query (&ts);
637 /* hundreds of nanoseconds */
638 static_assert ((10000000 % CLOCK_FREQ) == 0, "Broken frequencies ratio");
639 return ts / (10000000 / CLOCK_FREQ);
642 static mtime_t mdate_tick (void)
644 #if (_WIN32_WINNT >= 0x0600)
645 ULONGLONG ts = GetTickCount64 ();
647 ULONGLONG ts = clk.tick.get ();
651 static_assert ((CLOCK_FREQ % 1000) == 0, "Broken frequencies ratio");
652 return ts * (CLOCK_FREQ / 1000);
654 #include <mmsystem.h>
655 static mtime_t mdate_multimedia (void)
657 DWORD ts = timeGetTime ();
660 static_assert ((CLOCK_FREQ % 1000) == 0, "Broken frequencies ratio");
661 return ts * (CLOCK_FREQ / 1000);
664 static mtime_t mdate_perf (void)
666 /* We don't need the real date, just the value of a high precision timer */
667 LARGE_INTEGER counter;
668 if (!QueryPerformanceCounter (&counter))
671 /* Convert to from (1/freq) to microsecond resolution */
672 /* We need to split the division to avoid 63-bits overflow */
673 lldiv_t d = lldiv (counter.QuadPart, clk.perf.freq.QuadPart);
675 return (d.quot * 1000000) + ((d.rem * 1000000) / clk.perf.freq.QuadPart);
678 static mtime_t mdate_wall (void)
683 #if (_WIN32_WINNT >= 0x0602)
684 GetSystemTimePreciseAsFileTime (&ts);
686 GetSystemTimeAsFileTime (&ts);
688 s.LowPart = ts.dwLowDateTime;
689 s.HighPart = ts.dwHighDateTime;
690 /* hundreds of nanoseconds */
691 static_assert ((10000000 % CLOCK_FREQ) == 0, "Broken frequencies ratio");
692 return s.QuadPart / (10000000 / CLOCK_FREQ);
696 void mwait (mtime_t deadline)
701 while ((delay = (deadline - mdate())) > 0)
704 if (unlikely(delay > 0x7fffffff))
712 void msleep (mtime_t delay)
714 mwait (mdate () + delay);
717 static void SelectClockSource (vlc_object_t *obj)
719 EnterCriticalSection (&clock_lock);
720 if (mdate_selected != mdate_giveup)
722 LeaveCriticalSection (&clock_lock);
726 const char *name = "multimedia";
727 char *str = var_InheritString (obj, "clock-source");
730 if (!strcmp (name, "interrupt"))
732 msg_Dbg (obj, "using interrupt time as clock source");
733 #if (_WIN32_WINNT < 0x0601)
734 HANDLE h = GetModuleHandle (_T("kernel32.dll"));
735 if (unlikely(h == NULL))
737 clk.interrupt.query = (void *)GetProcAddress (h,
738 "QueryUnbiasedInterruptTime");
739 if (unlikely(clk.interrupt.query == NULL))
742 mdate_selected = mdate_interrupt;
745 if (!strcmp (name, "tick"))
747 msg_Dbg (obj, "using Windows time as clock source");
748 #if (_WIN32_WINNT < 0x0601)
749 HANDLE h = GetModuleHandle (_T("kernel32.dll"));
750 if (unlikely(h == NULL))
752 clk.tick.get = (void *)GetProcAddress (h, "GetTickCount64");
753 if (unlikely(clk.tick.get == NULL))
756 mdate_selected = mdate_tick;
759 if (!strcmp (name, "multimedia"))
763 msg_Dbg (obj, "using multimedia timers as clock source");
764 if (timeGetDevCaps (&caps, sizeof (caps)) != MMSYSERR_NOERROR)
766 msg_Dbg (obj, " min period: %u ms, max period: %u ms",
767 caps.wPeriodMin, caps.wPeriodMax);
768 mdate_selected = mdate_multimedia;
771 if (!strcmp (name, "perf"))
773 msg_Dbg (obj, "using performance counters as clock source");
774 if (!QueryPerformanceFrequency (&clk.perf.freq))
776 msg_Dbg (obj, " frequency: %llu Hz", clk.perf.freq.QuadPart);
777 mdate_selected = mdate_perf;
780 if (!strcmp (name, "wall"))
782 msg_Dbg (obj, "using system time as clock source");
783 mdate_selected = mdate_wall;
787 msg_Err (obj, "invalid clock source \"%s\"", name);
790 LeaveCriticalSection (&clock_lock);
794 #define xstrdup(str) (strdup(str) ?: (abort(), NULL))
796 size_t EnumClockSource (vlc_object_t *obj, const char *var,
797 char ***vp, char ***np)
799 const size_t max = 6;
800 char **values = xmalloc (sizeof (*values) * max);
801 char **names = xmalloc (sizeof (*names) * max);
804 #if (_WIN32_WINNT < 0x0601)
805 DWORD version = LOWORD(GetVersion());
806 version = (LOBYTE(version) << 8) | (HIBYTE(version) << 0);
809 values[n] = xstrdup ("");
810 names[n] = xstrdup (_("Auto"));
812 #if (_WIN32_WINNT < 0x0601)
813 if (version >= 0x0601)
816 values[n] = xstrdup ("interrupt");
817 names[n] = xstrdup ("Interrupt time");
820 #if (_WIN32_WINNT < 0x0600)
821 if (version >= 0x0600)
824 values[n] = xstrdup ("tick");
825 names[n] = xstrdup ("Windows time");
828 values[n] = xstrdup ("multimedia");
829 names[n] = xstrdup ("Multimedia timers");
831 values[n] = xstrdup ("perf");
832 names[n] = xstrdup ("Performance counters");
834 values[n] = xstrdup ("wall");
835 names[n] = xstrdup ("System time (DANGEROUS!)");
840 (void) obj; (void) var;
849 void (*func) (void *);
853 static void CALLBACK vlc_timer_do (void *val, BOOLEAN timeout)
855 struct vlc_timer *timer = val;
858 timer->func (timer->data);
861 int vlc_timer_create (vlc_timer_t *id, void (*func) (void *), void *data)
863 struct vlc_timer *timer = malloc (sizeof (*timer));
869 timer->handle = INVALID_HANDLE_VALUE;
874 void vlc_timer_destroy (vlc_timer_t timer)
876 if (timer->handle != INVALID_HANDLE_VALUE)
877 DeleteTimerQueueTimer (NULL, timer->handle, INVALID_HANDLE_VALUE);
881 void vlc_timer_schedule (vlc_timer_t timer, bool absolute,
882 mtime_t value, mtime_t interval)
884 if (timer->handle != INVALID_HANDLE_VALUE)
886 DeleteTimerQueueTimer (NULL, timer->handle, NULL);
887 timer->handle = INVALID_HANDLE_VALUE;
894 value = (value + 999) / 1000;
895 interval = (interval + 999) / 1000;
897 if (!CreateTimerQueueTimer (&timer->handle, NULL, vlc_timer_do, timer,
898 value, interval, WT_EXECUTEDEFAULT))
902 unsigned vlc_timer_getoverrun (vlc_timer_t timer)
910 unsigned vlc_GetCPUCount (void)
912 SYSTEM_INFO systemInfo;
914 GetNativeSystemInfo(&systemInfo);
916 return systemInfo.dwNumberOfProcessors;
920 /*** Initialization ***/
921 void vlc_threads_setup (libvlc_int_t *p_libvlc)
923 SelectClockSource (VLC_OBJECT(p_libvlc));
926 extern vlc_rwlock_t config_lock, msg_lock;
927 BOOL WINAPI DllMain (HINSTANCE, DWORD, LPVOID);
929 BOOL WINAPI DllMain (HINSTANCE hinstDll, DWORD fdwReason, LPVOID lpvReserved)
936 case DLL_PROCESS_ATTACH:
937 InitializeCriticalSection (&clock_lock);
938 vlc_mutex_init (&super_mutex);
939 vlc_cond_init (&super_variable);
940 vlc_threadvar_create (&thread_key, NULL);
941 vlc_rwlock_init (&config_lock);
942 vlc_rwlock_init (&msg_lock);
946 case DLL_PROCESS_DETACH:
947 vlc_rwlock_destroy (&msg_lock);
948 vlc_rwlock_destroy (&config_lock);
949 vlc_threadvar_delete (&thread_key);
950 vlc_cond_destroy (&super_variable);
951 vlc_mutex_destroy (&super_mutex);
952 DeleteCriticalSection (&clock_lock);