4 * Copyright 1996 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/port.h"
27 #include <sys/types.h>
33 #define WIN32_NO_STATUS
38 #include "wine/exception.h"
39 #include "wine/library.h"
40 #include "wine/server.h"
41 #include "wine/debug.h"
43 #include "kernel_private.h"
45 WINE_DEFAULT_DEBUG_CHANNEL(thread
);
48 /***********************************************************************
49 * CreateThread (KERNEL32.@)
51 HANDLE WINAPI DECLSPEC_HOTPATCH
CreateThread( SECURITY_ATTRIBUTES
*sa
, SIZE_T stack
, LPTHREAD_START_ROUTINE start
,
52 LPVOID param
, DWORD flags
, LPDWORD id
)
54 return CreateRemoteThread( GetCurrentProcess(),
55 sa
, stack
, start
, param
, flags
, id
);
59 /***************************************************************************
60 * CreateRemoteThread (KERNEL32.@)
62 * Creates a thread that runs in the address space of another process
67 * Success: Handle to the new thread.
68 * Failure: NULL. Use GetLastError() to find the error cause.
71 * Improper memory allocation: there's no ability to free new_thread_info
73 * Bad start address for RtlCreateUserThread because the library
74 * may be loaded at different address in other process.
76 HANDLE WINAPI
CreateRemoteThread( HANDLE hProcess
, SECURITY_ATTRIBUTES
*sa
, SIZE_T stack
,
77 LPTHREAD_START_ROUTINE start
, LPVOID param
,
78 DWORD flags
, LPDWORD id
)
83 SIZE_T stack_reserve
= 0, stack_commit
= 0;
85 if (flags
& STACK_SIZE_PARAM_IS_A_RESERVATION
) stack_reserve
= stack
;
86 else stack_commit
= stack
;
88 status
= RtlCreateUserThread( hProcess
, NULL
, TRUE
,
89 NULL
, stack_reserve
, stack_commit
,
90 (PRTL_THREAD_START_ROUTINE
)start
, param
, &handle
, &client_id
);
91 if (status
== STATUS_SUCCESS
)
93 if (id
) *id
= HandleToULong(client_id
.UniqueThread
);
94 if (sa
&& (sa
->nLength
>= sizeof(*sa
)) && sa
->bInheritHandle
)
95 SetHandleInformation( handle
, HANDLE_FLAG_INHERIT
, HANDLE_FLAG_INHERIT
);
96 if (!(flags
& CREATE_SUSPENDED
))
99 if (NtResumeThread( handle
, &ret
))
102 SetLastError( ERROR_NOT_ENOUGH_MEMORY
);
109 SetLastError( RtlNtStatusToDosError(status
) );
116 /***********************************************************************
117 * OpenThread [KERNEL32.@] Retrieves a handle to a thread from its thread id
119 HANDLE WINAPI
OpenThread( DWORD dwDesiredAccess
, BOOL bInheritHandle
, DWORD dwThreadId
)
123 OBJECT_ATTRIBUTES attr
;
126 attr
.Length
= sizeof(attr
);
127 attr
.RootDirectory
= 0;
128 attr
.Attributes
= bInheritHandle
? OBJ_INHERIT
: 0;
129 attr
.ObjectName
= NULL
;
130 attr
.SecurityDescriptor
= NULL
;
131 attr
.SecurityQualityOfService
= NULL
;
133 cid
.UniqueProcess
= 0; /* FIXME */
134 cid
.UniqueThread
= ULongToHandle(dwThreadId
);
135 status
= NtOpenThread( &handle
, dwDesiredAccess
, &attr
, &cid
);
138 SetLastError( RtlNtStatusToDosError(status
) );
145 /***********************************************************************
146 * ExitThread [KERNEL32.@] Ends a thread
151 void WINAPI
ExitThread( DWORD code
) /* [in] Exit code for this thread */
153 RtlExitUserThread( code
);
157 /**********************************************************************
158 * TerminateThread [KERNEL32.@] Terminates a thread
164 BOOL WINAPI
TerminateThread( HANDLE handle
, /* [in] Handle to thread */
165 DWORD exit_code
) /* [in] Exit code for thread */
167 NTSTATUS status
= NtTerminateThread( handle
, exit_code
);
168 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
173 /***********************************************************************
174 * FreeLibraryAndExitThread (KERNEL32.@)
176 void WINAPI
FreeLibraryAndExitThread(HINSTANCE hLibModule
, DWORD dwExitCode
)
178 FreeLibrary(hLibModule
);
179 ExitThread(dwExitCode
);
183 /**********************************************************************
184 * GetExitCodeThread (KERNEL32.@)
186 * Gets termination status of thread.
192 BOOL WINAPI
GetExitCodeThread(
193 HANDLE hthread
, /* [in] Handle to thread */
194 LPDWORD exitcode
) /* [out] Address to receive termination status */
196 THREAD_BASIC_INFORMATION info
;
197 NTSTATUS status
= NtQueryInformationThread( hthread
, ThreadBasicInformation
,
198 &info
, sizeof(info
), NULL
);
202 SetLastError( RtlNtStatusToDosError(status
) );
205 if (exitcode
) *exitcode
= info
.ExitStatus
;
210 /***********************************************************************
211 * SetThreadContext [KERNEL32.@] Sets context of thread.
217 BOOL WINAPI
SetThreadContext( HANDLE handle
, /* [in] Handle to thread with context */
218 const CONTEXT
*context
) /* [in] Address of context structure */
220 NTSTATUS status
= NtSetContextThread( handle
, context
);
221 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
226 /***********************************************************************
227 * GetThreadContext [KERNEL32.@] Retrieves context of thread.
233 BOOL WINAPI
GetThreadContext( HANDLE handle
, /* [in] Handle to thread with context */
234 CONTEXT
*context
) /* [out] Address of context structure */
236 NTSTATUS status
= NtGetContextThread( handle
, context
);
237 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
242 /**********************************************************************
243 * SuspendThread [KERNEL32.@] Suspends a thread.
246 * Success: Previous suspend count
247 * Failure: 0xFFFFFFFF
249 DWORD WINAPI
SuspendThread( HANDLE hthread
) /* [in] Handle to the thread */
252 NTSTATUS status
= NtSuspendThread( hthread
, &ret
);
257 SetLastError( RtlNtStatusToDosError(status
) );
263 /**********************************************************************
264 * ResumeThread [KERNEL32.@] Resumes a thread.
266 * Decrements a thread's suspend count. When count is zero, the
267 * execution of the thread is resumed.
270 * Success: Previous suspend count
271 * Failure: 0xFFFFFFFF
274 DWORD WINAPI
ResumeThread( HANDLE hthread
) /* [in] Identifies thread to restart */
277 NTSTATUS status
= NtResumeThread( hthread
, &ret
);
282 SetLastError( RtlNtStatusToDosError(status
) );
288 /**********************************************************************
289 * GetThreadPriority [KERNEL32.@] Returns priority for thread.
292 * Success: Thread's priority level.
293 * Failure: THREAD_PRIORITY_ERROR_RETURN
295 INT WINAPI
GetThreadPriority(
296 HANDLE hthread
) /* [in] Handle to thread */
298 THREAD_BASIC_INFORMATION info
;
299 NTSTATUS status
= NtQueryInformationThread( hthread
, ThreadBasicInformation
,
300 &info
, sizeof(info
), NULL
);
304 SetLastError( RtlNtStatusToDosError(status
) );
305 return THREAD_PRIORITY_ERROR_RETURN
;
307 return info
.Priority
;
311 /**********************************************************************
312 * SetThreadPriority [KERNEL32.@] Sets priority for thread.
318 BOOL WINAPI
SetThreadPriority(
319 HANDLE hthread
, /* [in] Handle to thread */
320 INT priority
) /* [in] Thread priority level */
322 DWORD prio
= priority
;
325 status
= NtSetInformationThread(hthread
, ThreadBasePriority
,
326 &prio
, sizeof(prio
));
330 SetLastError( RtlNtStatusToDosError(status
) );
338 /**********************************************************************
339 * GetThreadPriorityBoost [KERNEL32.@] Returns priority boost for thread.
341 * Always reports that priority boost is disabled.
347 BOOL WINAPI
GetThreadPriorityBoost(
348 HANDLE hthread
, /* [in] Handle to thread */
349 PBOOL pstate
) /* [out] pointer to var that receives the boost state */
351 if (pstate
) *pstate
= FALSE
;
356 /**********************************************************************
357 * SetThreadPriorityBoost [KERNEL32.@] Sets priority boost for thread.
359 * Priority boost is not implemented, but we return TRUE
360 * anyway because some games crash otherwise.
362 BOOL WINAPI
SetThreadPriorityBoost(
363 HANDLE hthread
, /* [in] Handle to thread */
364 BOOL disable
) /* [in] TRUE to disable priority boost */
370 /**********************************************************************
371 * SetThreadStackGuarantee (KERNEL32.@)
373 BOOL WINAPI
SetThreadStackGuarantee(PULONG stacksize
)
377 FIXME("(%p): stub\n", stacksize
);
381 /**********************************************************************
382 * SetThreadAffinityMask (KERNEL32.@)
384 DWORD_PTR WINAPI
SetThreadAffinityMask( HANDLE hThread
, DWORD_PTR dwThreadAffinityMask
)
387 THREAD_BASIC_INFORMATION tbi
;
389 status
= NtQueryInformationThread( hThread
, ThreadBasicInformation
,
390 &tbi
, sizeof(tbi
), NULL
);
393 SetLastError( RtlNtStatusToDosError(status
) );
396 status
= NtSetInformationThread( hThread
, ThreadAffinityMask
,
397 &dwThreadAffinityMask
,
398 sizeof(dwThreadAffinityMask
));
401 SetLastError( RtlNtStatusToDosError(status
) );
404 return tbi
.AffinityMask
;
408 /**********************************************************************
409 * SetThreadIdealProcessor [KERNEL32.@] Sets preferred processor for thread.
412 * Success: Value of last call to SetThreadIdealProcessor
415 DWORD WINAPI
SetThreadIdealProcessor(
416 HANDLE hThread
, /* [in] Specifies the thread of interest */
417 DWORD dwIdealProcessor
) /* [in] Specifies the new preferred processor */
419 FIXME("(%p): stub\n",hThread
);
420 if (dwIdealProcessor
> MAXIMUM_PROCESSORS
)
422 SetLastError(ERROR_INVALID_PARAMETER
);
429 /***********************************************************************
430 * GetThreadSelectorEntry (KERNEL32.@)
432 BOOL WINAPI
GetThreadSelectorEntry( HANDLE hthread
, DWORD sel
, LPLDT_ENTRY ldtent
)
434 THREAD_DESCRIPTOR_INFORMATION tdi
;
438 status
= NtQueryInformationThread( hthread
, ThreadDescriptorTableEntry
, &tdi
, sizeof(tdi
), NULL
);
441 SetLastError( RtlNtStatusToDosError(status
) );
449 /* callback for QueueUserAPC */
450 static void CALLBACK
call_user_apc( ULONG_PTR arg1
, ULONG_PTR arg2
, ULONG_PTR arg3
)
452 PAPCFUNC func
= (PAPCFUNC
)arg1
;
456 /***********************************************************************
457 * QueueUserAPC (KERNEL32.@)
459 DWORD WINAPI
QueueUserAPC( PAPCFUNC func
, HANDLE hthread
, ULONG_PTR data
)
461 NTSTATUS status
= NtQueueApcThread( hthread
, call_user_apc
, (ULONG_PTR
)func
, data
, 0 );
463 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
467 /***********************************************************************
468 * QueueUserWorkItem (KERNEL32.@)
470 BOOL WINAPI
QueueUserWorkItem( LPTHREAD_START_ROUTINE Function
, PVOID Context
, ULONG Flags
)
474 TRACE("(%p,%p,0x%08x)\n", Function
, Context
, Flags
);
476 status
= RtlQueueWorkItem( Function
, Context
, Flags
);
478 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
482 /**********************************************************************
483 * GetThreadTimes [KERNEL32.@] Obtains timing information.
489 BOOL WINAPI
GetThreadTimes(
490 HANDLE thread
, /* [in] Specifies the thread of interest */
491 LPFILETIME creationtime
, /* [out] When the thread was created */
492 LPFILETIME exittime
, /* [out] When the thread was destroyed */
493 LPFILETIME kerneltime
, /* [out] Time thread spent in kernel mode */
494 LPFILETIME usertime
) /* [out] Time thread spent in user mode */
496 KERNEL_USER_TIMES kusrt
;
499 status
= NtQueryInformationThread(thread
, ThreadTimes
, &kusrt
,
500 sizeof(kusrt
), NULL
);
503 SetLastError( RtlNtStatusToDosError(status
) );
508 creationtime
->dwLowDateTime
= kusrt
.CreateTime
.u
.LowPart
;
509 creationtime
->dwHighDateTime
= kusrt
.CreateTime
.u
.HighPart
;
513 exittime
->dwLowDateTime
= kusrt
.ExitTime
.u
.LowPart
;
514 exittime
->dwHighDateTime
= kusrt
.ExitTime
.u
.HighPart
;
518 kerneltime
->dwLowDateTime
= kusrt
.KernelTime
.u
.LowPart
;
519 kerneltime
->dwHighDateTime
= kusrt
.KernelTime
.u
.HighPart
;
523 usertime
->dwLowDateTime
= kusrt
.UserTime
.u
.LowPart
;
524 usertime
->dwHighDateTime
= kusrt
.UserTime
.u
.HighPart
;
530 /**********************************************************************
531 * GetThreadId [KERNEL32.@]
533 * Retrieve the identifier of a thread.
536 * Thread [I] The thread to retrieve the identifier of.
539 * Success: Identifier of the target thread.
542 DWORD WINAPI
GetThreadId(HANDLE Thread
)
544 THREAD_BASIC_INFORMATION tbi
;
547 TRACE("(%p)\n", Thread
);
549 status
= NtQueryInformationThread(Thread
, ThreadBasicInformation
, &tbi
,
553 SetLastError( RtlNtStatusToDosError(status
) );
557 return HandleToULong(tbi
.ClientId
.UniqueThread
);
561 /***********************************************************************
562 * GetCurrentThread [KERNEL32.@] Gets pseudohandle for current thread
565 * Pseudohandle for the current thread
567 #undef GetCurrentThread
568 HANDLE WINAPI
GetCurrentThread(void)
570 return (HANDLE
)~(ULONG_PTR
)1;
576 /***********************************************************************
577 * SetLastError (KERNEL32.@)
579 /* void WINAPI SetLastError( DWORD error ); */
580 __ASM_STDCALL_FUNC( SetLastError
, 4,
581 "movl 4(%esp),%eax\n\t"
586 /***********************************************************************
587 * GetLastError (KERNEL32.@)
589 /* DWORD WINAPI GetLastError(void); */
590 __ASM_STDCALL_FUNC( GetLastError
, 0, ".byte 0x64\n\tmovl 0x34,%eax\n\tret" )
592 /***********************************************************************
593 * GetCurrentProcessId (KERNEL32.@)
595 /* DWORD WINAPI GetCurrentProcessId(void) */
596 __ASM_STDCALL_FUNC( GetCurrentProcessId
, 0, ".byte 0x64\n\tmovl 0x20,%eax\n\tret" )
598 /***********************************************************************
599 * GetCurrentThreadId (KERNEL32.@)
601 /* DWORD WINAPI GetCurrentThreadId(void) */
602 __ASM_STDCALL_FUNC( GetCurrentThreadId
, 0, ".byte 0x64\n\tmovl 0x24,%eax\n\tret" )
604 /***********************************************************************
605 * GetProcessHeap (KERNEL32.@)
607 /* HANDLE WINAPI GetProcessHeap(void) */
608 __ASM_STDCALL_FUNC( GetProcessHeap
, 0, ".byte 0x64\n\tmovl 0x30,%eax\n\tmovl 0x18(%eax),%eax\n\tret");
610 #elif defined(__x86_64__)
612 /***********************************************************************
613 * SetLastError (KERNEL32.@)
615 /* void WINAPI SetLastError( DWORD error ); */
616 __ASM_STDCALL_FUNC( SetLastError
, 8, ".byte 0x65\n\tmovl %ecx,0x68\n\tret" );
618 /***********************************************************************
619 * GetLastError (KERNEL32.@)
621 /* DWORD WINAPI GetLastError(void); */
622 __ASM_STDCALL_FUNC( GetLastError
, 0, ".byte 0x65\n\tmovl 0x68,%eax\n\tret" );
624 /***********************************************************************
625 * GetCurrentProcessId (KERNEL32.@)
627 /* DWORD WINAPI GetCurrentProcessId(void) */
628 __ASM_STDCALL_FUNC( GetCurrentProcessId
, 0, ".byte 0x65\n\tmovl 0x40,%eax\n\tret" );
630 /***********************************************************************
631 * GetCurrentThreadId (KERNEL32.@)
633 /* DWORD WINAPI GetCurrentThreadId(void) */
634 __ASM_STDCALL_FUNC( GetCurrentThreadId
, 0, ".byte 0x65\n\tmovl 0x48,%eax\n\tret" );
636 /***********************************************************************
637 * GetProcessHeap (KERNEL32.@)
639 /* HANDLE WINAPI GetProcessHeap(void) */
640 __ASM_STDCALL_FUNC( GetProcessHeap
, 0, ".byte 0x65\n\tmovq 0x60,%rax\n\tmovq 0x30(%rax),%rax\n\tret");
642 #else /* __x86_64__ */
644 /**********************************************************************
645 * SetLastError (KERNEL32.@)
647 * Sets the last-error code.
652 void WINAPI
SetLastError( DWORD error
) /* [in] Per-thread error code */
654 NtCurrentTeb()->LastErrorValue
= error
;
657 /**********************************************************************
658 * GetLastError (KERNEL32.@)
660 * Get the last-error code.
665 DWORD WINAPI
GetLastError(void)
667 return NtCurrentTeb()->LastErrorValue
;
670 /***********************************************************************
671 * GetCurrentProcessId (KERNEL32.@)
673 * Get the current process identifier.
676 * current process identifier
678 DWORD WINAPI
GetCurrentProcessId(void)
680 return HandleToULong(NtCurrentTeb()->ClientId
.UniqueProcess
);
683 /***********************************************************************
684 * GetCurrentThreadId (KERNEL32.@)
686 * Get the current thread identifier.
689 * current thread identifier
691 DWORD WINAPI
GetCurrentThreadId(void)
693 return HandleToULong(NtCurrentTeb()->ClientId
.UniqueThread
);
696 /***********************************************************************
697 * GetProcessHeap (KERNEL32.@)
699 HANDLE WINAPI
GetProcessHeap(void)
701 return NtCurrentTeb()->Peb
->ProcessHeap
;
704 #endif /* __i386__ */
706 /*************************************************************************
707 * rtlmode_to_win32mode
709 static DWORD
rtlmode_to_win32mode( DWORD rtlmode
)
714 win32mode
|= SEM_FAILCRITICALERRORS
;
716 win32mode
|= SEM_NOGPFAULTERRORBOX
;
718 win32mode
|= SEM_NOOPENFILEERRORBOX
;
723 /***********************************************************************
724 * SetThreadErrorMode (KERNEL32.@)
726 * Set the thread local error mode.
729 * mode [I] The new error mode, a bitwise or of SEM_FAILCRITICALERRORS,
730 * SEM_NOGPFAULTERRORBOX and SEM_NOOPENFILEERRORBOX.
731 * oldmode [O] Destination of the old error mode (may be NULL)
735 * Failure: FALSE, check GetLastError
737 BOOL WINAPI
SetThreadErrorMode( DWORD mode
, LPDWORD oldmode
)
742 if (mode
& ~(SEM_FAILCRITICALERRORS
|
743 SEM_NOGPFAULTERRORBOX
|
744 SEM_NOOPENFILEERRORBOX
))
746 SetLastError( ERROR_INVALID_PARAMETER
);
750 if (mode
& SEM_FAILCRITICALERRORS
)
752 if (mode
& SEM_NOGPFAULTERRORBOX
)
754 if (mode
& SEM_NOOPENFILEERRORBOX
)
757 status
= RtlSetThreadErrorMode( tmp
, oldmode
);
760 SetLastError( RtlNtStatusToDosError(status
) );
765 *oldmode
= rtlmode_to_win32mode(*oldmode
);
770 /***********************************************************************
771 * GetThreadErrorMode (KERNEL32.@)
773 * Get the thread local error mode.
779 * The current thread local error mode.
781 DWORD WINAPI
GetThreadErrorMode( void )
783 return rtlmode_to_win32mode( RtlGetThreadErrorMode() );
786 /***********************************************************************
787 * GetThreadUILanguage (KERNEL32.@)
789 * Get the current thread's language identifier.
795 * The current thread's language identifier.
797 LANGID WINAPI
GetThreadUILanguage( void )
800 NtQueryDefaultUILanguage( &lang
);
801 FIXME(": stub, returning default language.\n");
805 /***********************************************************************
806 * GetThreadIOPendingFlag (KERNEL32.@)
808 BOOL WINAPI
GetThreadIOPendingFlag( HANDLE thread
, PBOOL io_pending
)
810 FIXME("%p, %p\n", thread
, io_pending
);
815 /***********************************************************************
816 * SetThreadPreferredUILanguages (KERNEL32.@)
818 BOOL WINAPI
SetThreadPreferredUILanguages( DWORD flags
, PCZZWSTR buffer
, PULONG count
)
820 FIXME( "%u, %p, %p\n", flags
, buffer
, count
);
824 /***********************************************************************
825 * GetThreadPreferredUILanguages (KERNEL32.@)
827 BOOL WINAPI
GetThreadPreferredUILanguages( DWORD flags
, PULONG count
, PCZZWSTR buffer
, PULONG buffersize
)
829 FIXME( "%u, %p, %p %p\n", flags
, count
, buffer
, buffersize
);