- Add some final missing annotations to kill.c

[AUDIT]
 - Most of the functions are documented at length in Windows Internals II and at a more high-level fashion in Windows Internals 4 and were based on that information. Undocumented routines were based of the operations done in the documented ones (for example, freeing buffers that we know were allocated, etc).

svn path=/trunk/; revision=23195
This commit is contained in:
Alex Ionescu 2006-07-20 16:30:07 +00:00
parent a92681004e
commit 40a3a52a7b
2 changed files with 16 additions and 17 deletions

View file

@ -28,7 +28,6 @@
// - Use Process/Thread Rundown. // - Use Process/Thread Rundown.
// - Use Process Pushlock Locks. // - Use Process Pushlock Locks.
// - Use Safe Referencing where needed. // - Use Safe Referencing where needed.
// - Use Guarded Mutex instead of Fast Mutex for Active Process Locks.
// - Use Security Locks in security.c // - Use Security Locks in security.c
// - Figure out why processes don't die. // - Figure out why processes don't die.
// - Generate process cookie for user-more thread. // - Generate process cookie for user-more thread.

View file

@ -90,7 +90,7 @@ PspExitApcRundown(IN PKAPC Apc)
VOID VOID
NTAPI NTAPI
PspReapRoutine(PVOID Context) PspReapRoutine(IN PVOID Context)
{ {
PLIST_ENTRY *ListAddr; PLIST_ENTRY *ListAddr;
PLIST_ENTRY NextEntry; PLIST_ENTRY NextEntry;
@ -130,7 +130,7 @@ PspReapRoutine(PVOID Context)
VOID VOID
NTAPI NTAPI
PspDeleteProcess(PVOID ObjectBody) PspDeleteProcess(IN PVOID ObjectBody)
{ {
PEPROCESS Process = (PEPROCESS)ObjectBody; PEPROCESS Process = (PEPROCESS)ObjectBody;
KAPC_STATE ApcState; KAPC_STATE ApcState;
@ -260,7 +260,7 @@ PspDeleteProcess(PVOID ObjectBody)
VOID VOID
NTAPI NTAPI
PspDeleteThread(PVOID ObjectBody) PspDeleteThread(IN PVOID ObjectBody)
{ {
PETHREAD Thread = (PETHREAD)ObjectBody; PETHREAD Thread = (PETHREAD)ObjectBody;
PEPROCESS Process = Thread->ThreadsProcess; PEPROCESS Process = Thread->ThreadsProcess;
@ -315,7 +315,7 @@ PspDeleteThread(PVOID ObjectBody)
*/ */
VOID VOID
NTAPI NTAPI
PspExitThread(NTSTATUS ExitStatus) PspExitThread(IN NTSTATUS ExitStatus)
{ {
CLIENT_DIED_MSG TerminationMsg; CLIENT_DIED_MSG TerminationMsg;
NTSTATUS Status; NTSTATUS Status;
@ -726,11 +726,11 @@ TryAgain2:
VOID VOID
NTAPI NTAPI
PsExitSpecialApc(PKAPC Apc, PsExitSpecialApc(IN PKAPC Apc,
PKNORMAL_ROUTINE* NormalRoutine, IN OUT PKNORMAL_ROUTINE* NormalRoutine,
PVOID* NormalContext, IN OUT PVOID* NormalContext,
PVOID* SystemArgument1, IN OUT PVOID* SystemArgument1,
PVOID* SystemArguemnt2) IN OUT PVOID* SystemArguemnt2)
{ {
NTSTATUS Status; NTSTATUS Status;
PAGED_CODE(); PAGED_CODE();
@ -749,9 +749,9 @@ PsExitSpecialApc(PKAPC Apc,
VOID VOID
NTAPI NTAPI
PspExitNormalApc(PVOID NormalContext, PspExitNormalApc(IN PVOID NormalContext,
PVOID SystemArgument1, IN PVOID SystemArgument1,
PVOID SystemArgument2) IN PVOID SystemArgument2)
{ {
PKAPC Apc = (PKAPC)SystemArgument1; PKAPC Apc = (PKAPC)SystemArgument1;
PETHREAD Thread = PsGetCurrentThread(); PETHREAD Thread = PsGetCurrentThread();
@ -789,9 +789,9 @@ PspExitNormalApc(PVOID NormalContext,
*/ */
NTSTATUS NTSTATUS
NTAPI NTAPI
PspTerminateThreadByPointer(PETHREAD Thread, PspTerminateThreadByPointer(IN PETHREAD Thread,
NTSTATUS ExitStatus, IN NTSTATUS ExitStatus,
BOOLEAN bSelf) IN BOOLEAN bSelf)
{ {
PKAPC Apc; PKAPC Apc;
NTSTATUS Status = STATUS_SUCCESS; NTSTATUS Status = STATUS_SUCCESS;
@ -932,7 +932,7 @@ PspExitProcess(IN BOOLEAN LastThread,
*/ */
NTSTATUS NTSTATUS
NTAPI NTAPI
PsTerminateSystemThread(NTSTATUS ExitStatus) PsTerminateSystemThread(IN NTSTATUS ExitStatus)
{ {
PETHREAD Thread = PsGetCurrentThread(); PETHREAD Thread = PsGetCurrentThread();