[reactos] 01/01: [NTUSER] Add 'Win:' comments to some functions (#4453)

[Katayama Hirofumi MZ]

https://git.reactos.org/?p=reactos.git;a=commitdiff;h=567b0700fe6c36328a4be…

commit 567b0700fe6c36328a4beeef92994324bb11a23f
Author:     Katayama Hirofumi MZ <katayama.hirofumi.mz(a)gmail.com>
AuthorDate: Sun Apr 17 06:53:37 2022 +0900
Commit:     GitHub <noreply(a)github.com>
CommitDate: Sun Apr 17 06:53:37 2022 +0900

    [NTUSER] Add 'Win:' comments to some functions (#4453)
---
 win32ss/gdi/eng/error.c         | 1 +
 win32ss/user/ntuser/desktop.c   | 2 ++
 win32ss/user/ntuser/input.c     | 1 +
 win32ss/user/ntuser/misc.c      | 1 +
 win32ss/user/ntuser/ntuser.c    | 3 +++
 win32ss/user/ntuser/painting.c  | 3 +++
 win32ss/user/ntuser/userfuncs.h | 1 +
 win32ss/user/ntuser/window.c    | 5 ++++-
 win32ss/user/ntuser/winpos.c    | 2 ++
 9 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/win32ss/gdi/eng/error.c b/win32ss/gdi/eng/error.c
index 2ff36883b78..380869bfd6e 100644
--- a/win32ss/gdi/eng/error.c
+++ b/win32ss/gdi/eng/error.c
@@ -21,6 +21,7 @@ EngGetLastError(VOID)
 /*
  * @implemented
  * http://msdn.microsoft.com/en-us/library/ff565015%28VS.85%29.aspx
+ * Win: UserSetLastError
  */
 VOID
 APIENTRY
diff --git a/win32ss/user/ntuser/desktop.c b/win32ss/user/ntuser/desktop.c
index 11f3de29c78..ad00fc0c00e 100644
--- a/win32ss/user/ntuser/desktop.c
+++ b/win32ss/user/ntuser/desktop.c
@@ -1344,6 +1344,7 @@ PWND FASTCALL co_GetDesktopWindow(PWND pWnd)
     return NULL;
 }
 
+// Win: _GetDesktopWindow
 HWND FASTCALL IntGetDesktopWindow(VOID)
 {
     PDESKTOP pdo = IntGetActiveDesktop();
@@ -1368,6 +1369,7 @@ PWND FASTCALL UserGetDesktopWindow(VOID)
     return UserGetWindowObject(pdo->DesktopWindow);
 }
 
+// Win: _GetMessageWindow
 HWND FASTCALL IntGetMessageWindow(VOID)
 {
     PDESKTOP pdo = IntGetActiveDesktop();
diff --git a/win32ss/user/ntuser/input.c b/win32ss/user/ntuser/input.c
index 3f68406368f..cc0c8cf047f 100644
--- a/win32ss/user/ntuser/input.c
+++ b/win32ss/user/ntuser/input.c
@@ -475,6 +475,7 @@ IsRemoveAttachThread(PTHREADINFO pti)
     return Ret;
 }
 
+// Win: zzzAttachThreadInput
 NTSTATUS FASTCALL
 UserAttachThreadInput(PTHREADINFO ptiFrom, PTHREADINFO ptiTo, BOOL fAttach)
 {
diff --git a/win32ss/user/ntuser/misc.c b/win32ss/user/ntuser/misc.c
index 970d1b6c46d..5b1d3ecad83 100644
--- a/win32ss/user/ntuser/misc.c
+++ b/win32ss/user/ntuser/misc.c
@@ -35,6 +35,7 @@ _scwprintf(
 
 /*
  * Test the Thread to verify and validate it. Hard to the core tests are required.
+ * Win: PtiFromThreadId
  */
 PTHREADINFO
 FASTCALL
diff --git a/win32ss/user/ntuser/ntuser.c b/win32ss/user/ntuser/ntuser.c
index 220ed8db6af..b75e7b9b41b 100644
--- a/win32ss/user/ntuser/ntuser.c
+++ b/win32ss/user/ntuser/ntuser.c
@@ -238,12 +238,14 @@ VOID FASTCALL CleanupUserImpl(VOID)
     ExDeleteResourceLite(&UserLock);
 }
 
+// Win: EnterSharedCrit
 VOID FASTCALL UserEnterShared(VOID)
 {
     KeEnterCriticalRegion();
     ExAcquireResourceSharedLite(&UserLock, TRUE);
 }
 
+// Win: EnterCrit
 VOID FASTCALL UserEnterExclusive(VOID)
 {
     ASSERT_NOGDILOCKS();
@@ -252,6 +254,7 @@ VOID FASTCALL UserEnterExclusive(VOID)
     gptiCurrent = PsGetCurrentThreadWin32Thread();
 }
 
+// Win: LeaveCrit
 VOID FASTCALL UserLeave(VOID)
 {
     ASSERT_NOGDILOCKS();
diff --git a/win32ss/user/ntuser/painting.c b/win32ss/user/ntuser/painting.c
index e0e4893a4b0..352c934564d 100644
--- a/win32ss/user/ntuser/painting.c
+++ b/win32ss/user/ntuser/painting.c
@@ -1430,6 +1430,7 @@ IntFlashWindowEx(PWND pWnd, PFLASHWINFO pfwi)
    return Ret;
 }
 
+// Win: xxxBeginPaint
 HDC FASTCALL
 IntBeginPaint(PWND Window, PPAINTSTRUCT Ps)
 {
@@ -1526,6 +1527,7 @@ IntBeginPaint(PWND Window, PPAINTSTRUCT Ps)
    return Ps->hdc;
 }
 
+// Win: xxxEndPaint
 BOOL FASTCALL
 IntEndPaint(PWND Wnd, PPAINTSTRUCT Ps)
 {
@@ -1548,6 +1550,7 @@ IntEndPaint(PWND Wnd, PPAINTSTRUCT Ps)
    return TRUE;
 }
 
+// Win: xxxFillWindow
 BOOL FASTCALL
 IntFillWindow(PWND pWndParent,
               PWND pWnd,
diff --git a/win32ss/user/ntuser/userfuncs.h b/win32ss/user/ntuser/userfuncs.h
index 3bae17d5567..f91058dd539 100644
--- a/win32ss/user/ntuser/userfuncs.h
+++ b/win32ss/user/ntuser/userfuncs.h
@@ -1,5 +1,6 @@
 #pragma once
 
+// Win: ValidateHmenu
 FORCEINLINE PMENU UserGetMenuObject(HMENU hMenu)
 {
    PMENU pMenu = UserGetObject(gHandleTable, hMenu, TYPE_MENU);
diff --git a/win32ss/user/ntuser/window.c b/win32ss/user/ntuser/window.c
index 025e80e578f..da8da6cf68e 100644
--- a/win32ss/user/ntuser/window.c
+++ b/win32ss/user/ntuser/window.c
@@ -121,6 +121,7 @@ PWND FASTCALL ValidateHwndNoErr(HWND hWnd)
 }
 
 /* Temp HACK */
+// Win: ValidateHwnd
 PWND FASTCALL UserGetWindowObject(HWND hWnd)
 {
     PWND Window;
@@ -1263,6 +1264,7 @@ co_IntSetParent(PWND Wnd, PWND WndNewParent)
    return WndOldParent;
 }
 
+// Win: xxxSetParent
 HWND FASTCALL
 co_UserSetParent(HWND hWndChild, HWND hWndNewParent)
 {
@@ -2128,6 +2130,7 @@ Error:
 
 /*
  * @implemented
+ * Win: xxxCreateWindowEx
  */
 PWND FASTCALL
 co_UserCreateWindowEx(CREATESTRUCTW* Cs,
@@ -2742,7 +2745,7 @@ cleanup:
    return hwnd;
 }
 
-
+// Win: xxxDestroyWindow
 BOOLEAN co_UserDestroyWindow(PVOID Object)
 {
    HWND hWnd;
diff --git a/win32ss/user/ntuser/winpos.c b/win32ss/user/ntuser/winpos.c
index eba590fad13..27f594e554c 100644
--- a/win32ss/user/ntuser/winpos.c
+++ b/win32ss/user/ntuser/winpos.c
@@ -551,6 +551,7 @@ WinPosInitInternalPos(PWND Wnd, RECTL *RestoreRect)
    }
 }
 
+// Win: _GetWindowPlacement
 BOOL
 FASTCALL
 IntGetWindowPlacement(PWND Wnd, WINDOWPLACEMENT *lpwndpl)
@@ -2484,6 +2485,7 @@ co_WinPosMinMaximize(PWND Wnd, UINT ShowFlag, RECT* NewPos)
 
 /*
    ShowWindow does not set SWP_FRAMECHANGED!!! Fix wine msg
test_SetParent:WmSetParentSeq_2:23 wParam bits!
+   Win: xxxShowWindow
  */
 BOOLEAN FASTCALL
 co_WinPosShowWindow(PWND Wnd, INT Cmd)