[ros-diffs] [fireball] 22673: [FORMATTING] - Amend file header slightly - Add function header - STDCALL -> NTAPI

[fireball at svn.reactos.org]

Author: fireball
Date: Wed Jun 28 18:02:39 2006
New Revision: 22673

URL: http://svn.reactos.org/svn/reactos?rev=22673&view=rev
Log:
[FORMATTING]
- Amend file header slightly
- Add function header
- STDCALL -> NTAPI

Modified:
    trunk/reactos/ntoskrnl/ex/dbgctrl.c

Modified: trunk/reactos/ntoskrnl/ex/dbgctrl.c
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/ntoskrnl/ex/dbgctrl.c?rev=22673&r1=22672&r2=22673&view=diff
==============================================================================
--- trunk/reactos/ntoskrnl/ex/dbgctrl.c (original)
+++ trunk/reactos/ntoskrnl/ex/dbgctrl.c Wed Jun 28 18:02:39 2006
@@ -1,10 +1,9 @@
 /*
- * COPYRIGHT:       See COPYING in the top level directory
- * PROJECT:         ReactOS kernel
+ * PROJECT:         ReactOS Kernel
+ * LICENSE:         GPL - See COPYING in the top level directory
  * FILE:            ntoskrnl/ex/dbgctrl.c
  * PURPOSE:         System debug control
- *
- * PROGRAMMERS:     No programmer listed.
+ * PROGRAMMERS:     Alex Ionescu
  */
 
 /* INCLUDES *****************************************************************/
@@ -15,8 +14,45 @@
 
 /* FUNCTIONS *****************************************************************/
 
+/*++
+ * @name NtSystemDebugControl
+ * @implemented
+ *
+ * Perform various queries to debugger.
+ * This API is subject to test-case creation to further evaluate its
+ * abilities (if needed to at all)
+ *
+ * See: http://www.osronline.com/showthread.cfm?link=93915
+ *      http://void.ru/files/Ntexapi.h
+ *      http://www.codeguru.com/code/legacy/system/ntexapi.zip
+ *      http://www.securityfocus.com/bid/9694
+ *
+ * @param ControlCode
+ *        Description of the parameter. Wrapped to more lines on ~70th
+ *        column.
+ *
+ * @param InputBuffer
+ *        FILLME
+ *
+ * @param InputBufferLength
+ *        FILLME
+ *
+ * @param OutputBuffer
+ *        FILLME
+ *
+ * @param OutputBufferLength
+ *        FILLME
+ *
+  * @param ReturnLength
+ *        FILLME
+ *
+ * @return STATUS_SUCCESS in case of success, proper error code otherwise
+ *
+ * @remarks None
+ *
+ *--*/
 NTSTATUS
-STDCALL
+NTAPI
 NtSystemDebugControl(SYSDBG_COMMAND ControlCode,
                      PVOID InputBuffer,
                      ULONG InputBufferLength,