mirror of
https://github.com/libsdl-org/SDL.git
synced 2025-10-01 23:48:29 +00:00

We now only raise the magic exception that names the thread when IsDebuggerPresent() returns true. In such a case, Visual Studio will catch the exception, set the thread name, and let the debugged process continue normally. If the debugger isn't running, we don't raise an exception at all. Setting the name is a debugger trick; if the debugger isn't running, the name won't be set if attached later in any case, so this doesn't lose functionality. This lets this code work without assembly code, on win32 and win64, and across various compilers. The only "gotcha" is that if you have something attached that looks like a debugger but doesn't respect this magic exception trick, the process will likely crash, but that's probably a deficiency of the attached program. Fixes Bugzilla #2089.
219 lines
7.1 KiB
C
219 lines
7.1 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2016 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute it
|
|
freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
claim that you wrote the original software. If you use this software
|
|
in a product, an acknowledgment in the product documentation would be
|
|
appreciated but is not required.
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
misrepresented as being the original software.
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
*/
|
|
#include "../../SDL_internal.h"
|
|
|
|
#if SDL_THREAD_WINDOWS
|
|
|
|
/* Win32 thread management routines for SDL */
|
|
|
|
#include "SDL_thread.h"
|
|
#include "../SDL_thread_c.h"
|
|
#include "../SDL_systhread.h"
|
|
#include "SDL_systhread_c.h"
|
|
|
|
#ifndef SDL_PASSED_BEGINTHREAD_ENDTHREAD
|
|
/* We'll use the C library from this DLL */
|
|
#include <process.h>
|
|
|
|
/* Cygwin gcc-3 ... MingW64 (even with a i386 host) does this like MSVC. */
|
|
#if (defined(__MINGW32__) && (__GNUC__ < 4))
|
|
typedef unsigned long (__cdecl *pfnSDL_CurrentBeginThread) (void *, unsigned,
|
|
unsigned (__stdcall *func)(void *), void *arg,
|
|
unsigned, unsigned *threadID);
|
|
typedef void (__cdecl *pfnSDL_CurrentEndThread)(unsigned code);
|
|
|
|
#elif defined(__WATCOMC__)
|
|
/* This is for Watcom targets except OS2 */
|
|
#if __WATCOMC__ < 1240
|
|
#define __watcall
|
|
#endif
|
|
typedef unsigned long (__watcall * pfnSDL_CurrentBeginThread) (void *,
|
|
unsigned,
|
|
unsigned
|
|
(__stdcall *
|
|
func) (void
|
|
*),
|
|
void *arg,
|
|
unsigned,
|
|
unsigned
|
|
*threadID);
|
|
typedef void (__watcall * pfnSDL_CurrentEndThread) (unsigned code);
|
|
|
|
#else
|
|
typedef uintptr_t(__cdecl * pfnSDL_CurrentBeginThread) (void *, unsigned,
|
|
unsigned (__stdcall *
|
|
func) (void
|
|
*),
|
|
void *arg, unsigned,
|
|
unsigned *threadID);
|
|
typedef void (__cdecl * pfnSDL_CurrentEndThread) (unsigned code);
|
|
#endif
|
|
#endif /* !SDL_PASSED_BEGINTHREAD_ENDTHREAD */
|
|
|
|
|
|
typedef struct ThreadStartParms
|
|
{
|
|
void *args;
|
|
pfnSDL_CurrentEndThread pfnCurrentEndThread;
|
|
} tThreadStartParms, *pThreadStartParms;
|
|
|
|
static DWORD
|
|
RunThread(void *data)
|
|
{
|
|
pThreadStartParms pThreadParms = (pThreadStartParms) data;
|
|
pfnSDL_CurrentEndThread pfnEndThread = pThreadParms->pfnCurrentEndThread;
|
|
void *args = pThreadParms->args;
|
|
SDL_free(pThreadParms);
|
|
SDL_RunThread(args);
|
|
if (pfnEndThread != NULL)
|
|
pfnEndThread(0);
|
|
return (0);
|
|
}
|
|
|
|
static DWORD WINAPI
|
|
RunThreadViaCreateThread(LPVOID data)
|
|
{
|
|
return RunThread(data);
|
|
}
|
|
|
|
static unsigned __stdcall
|
|
RunThreadViaBeginThreadEx(void *data)
|
|
{
|
|
return (unsigned) RunThread(data);
|
|
}
|
|
|
|
#ifdef SDL_PASSED_BEGINTHREAD_ENDTHREAD
|
|
int
|
|
SDL_SYS_CreateThread(SDL_Thread * thread, void *args,
|
|
pfnSDL_CurrentBeginThread pfnBeginThread,
|
|
pfnSDL_CurrentEndThread pfnEndThread)
|
|
{
|
|
#elif defined(__CYGWIN__) || defined(__WINRT__)
|
|
int
|
|
SDL_SYS_CreateThread(SDL_Thread * thread, void *args)
|
|
{
|
|
pfnSDL_CurrentBeginThread pfnBeginThread = NULL;
|
|
pfnSDL_CurrentEndThread pfnEndThread = NULL;
|
|
#else
|
|
int
|
|
SDL_SYS_CreateThread(SDL_Thread * thread, void *args)
|
|
{
|
|
pfnSDL_CurrentBeginThread pfnBeginThread = (pfnSDL_CurrentBeginThread)_beginthreadex;
|
|
pfnSDL_CurrentEndThread pfnEndThread = (pfnSDL_CurrentEndThread)_endthreadex;
|
|
#endif /* SDL_PASSED_BEGINTHREAD_ENDTHREAD */
|
|
pThreadStartParms pThreadParms =
|
|
(pThreadStartParms) SDL_malloc(sizeof(tThreadStartParms));
|
|
if (!pThreadParms) {
|
|
return SDL_OutOfMemory();
|
|
}
|
|
/* Save the function which we will have to call to clear the RTL of calling app! */
|
|
pThreadParms->pfnCurrentEndThread = pfnEndThread;
|
|
/* Also save the real parameters we have to pass to thread function */
|
|
pThreadParms->args = args;
|
|
|
|
if (pfnBeginThread) {
|
|
unsigned threadid = 0;
|
|
thread->handle = (SYS_ThreadHandle)
|
|
((size_t) pfnBeginThread(NULL, 0, RunThreadViaBeginThreadEx,
|
|
pThreadParms, 0, &threadid));
|
|
} else {
|
|
DWORD threadid = 0;
|
|
thread->handle = CreateThread(NULL, 0, RunThreadViaCreateThread,
|
|
pThreadParms, 0, &threadid);
|
|
}
|
|
if (thread->handle == NULL) {
|
|
return SDL_SetError("Not enough resources to create thread");
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
#pragma pack(push,8)
|
|
typedef struct tagTHREADNAME_INFO
|
|
{
|
|
DWORD dwType; /* must be 0x1000 */
|
|
LPCSTR szName; /* pointer to name (in user addr space) */
|
|
DWORD dwThreadID; /* thread ID (-1=caller thread) */
|
|
DWORD dwFlags; /* reserved for future use, must be zero */
|
|
} THREADNAME_INFO;
|
|
#pragma pack(pop)
|
|
|
|
void
|
|
SDL_SYS_SetupThread(const char *name)
|
|
{
|
|
if ((name != NULL) && IsDebuggerPresent()) {
|
|
/* This magic tells the debugger to name a thread if it's listening. */
|
|
THREADNAME_INFO inf;
|
|
SDL_zero(inf);
|
|
inf.dwType = 0x1000;
|
|
inf.szName = name;
|
|
inf.dwThreadID = (DWORD) -1;
|
|
inf.dwFlags = 0;
|
|
|
|
/* The debugger catches this, renames the thread, continues on. */
|
|
RaiseException(0x406D1388, 0, sizeof(inf) / sizeof(ULONG), (const ULONG_PTR*) &inf);
|
|
}
|
|
}
|
|
|
|
SDL_threadID
|
|
SDL_ThreadID(void)
|
|
{
|
|
return ((SDL_threadID) GetCurrentThreadId());
|
|
}
|
|
|
|
int
|
|
SDL_SYS_SetThreadPriority(SDL_ThreadPriority priority)
|
|
{
|
|
int value;
|
|
|
|
if (priority == SDL_THREAD_PRIORITY_LOW) {
|
|
value = THREAD_PRIORITY_LOWEST;
|
|
} else if (priority == SDL_THREAD_PRIORITY_HIGH) {
|
|
value = THREAD_PRIORITY_HIGHEST;
|
|
} else {
|
|
value = THREAD_PRIORITY_NORMAL;
|
|
}
|
|
if (!SetThreadPriority(GetCurrentThread(), value)) {
|
|
return WIN_SetError("SetThreadPriority()");
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
void
|
|
SDL_SYS_WaitThread(SDL_Thread * thread)
|
|
{
|
|
#if __WINRT__
|
|
WaitForSingleObjectEx(thread->handle, INFINITE, FALSE);
|
|
#else
|
|
WaitForSingleObject(thread->handle, INFINITE);
|
|
#endif
|
|
CloseHandle(thread->handle);
|
|
}
|
|
|
|
void
|
|
SDL_SYS_DetachThread(SDL_Thread * thread)
|
|
{
|
|
CloseHandle(thread->handle);
|
|
}
|
|
|
|
#endif /* SDL_THREAD_WINDOWS */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|