2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS kernel
4 * PURPOSE: Keyboard functions
5 * FILE: subsystems/win32/win32k/ntuser/keyboard.c
6 * PROGRAMERS: Casper S. Hornstrup (chorns@users.sourceforge.net)
7 * Rafal Harabien (rafalh@reactos.org)
11 DBG_DEFAULT_CHANNEL(UserKbd
);
13 BYTE gafAsyncKeyState
[256 * 2 / 8]; // 2 bits per key
14 static BYTE gafAsyncKeyStateRecentDown
[256 / 8]; // 1 bit per key
15 static PKEYBOARD_INDICATOR_TRANSLATION gpKeyboardIndicatorTrans
= NULL
;
16 static KEYBOARD_INDICATOR_PARAMETERS gIndicators
= {0, 0};
18 /* FUNCTIONS *****************************************************************/
23 * Initialization -- Right now, just zero the key state
28 InitKeyboardImpl(VOID
)
30 RtlZeroMemory(&gafAsyncKeyState
, sizeof(gafAsyncKeyState
));
31 RtlZeroMemory(&gafAsyncKeyStateRecentDown
, sizeof(gafAsyncKeyStateRecentDown
));
32 return STATUS_SUCCESS
;
36 * IntKeyboardGetIndicatorTrans
38 * Asks the keyboard driver to send a small table that shows which
39 * lights should connect with which scancodes
43 IntKeyboardGetIndicatorTrans(HANDLE hKeyboardDevice
,
44 PKEYBOARD_INDICATOR_TRANSLATION
*ppIndicatorTrans
)
48 IO_STATUS_BLOCK Block
;
49 PKEYBOARD_INDICATOR_TRANSLATION pRet
;
51 dwSize
= sizeof(KEYBOARD_INDICATOR_TRANSLATION
);
53 pRet
= ExAllocatePoolWithTag(PagedPool
,
59 Status
= NtDeviceIoControlFile(hKeyboardDevice
,
64 IOCTL_KEYBOARD_QUERY_INDICATOR_TRANSLATION
,
68 if (Status
!= STATUS_BUFFER_TOO_SMALL
)
71 ExFreePoolWithTag(pRet
, USERTAG_KBDTABLE
);
73 dwSize
+= sizeof(KEYBOARD_INDICATOR_TRANSLATION
);
75 pRet
= ExAllocatePoolWithTag(PagedPool
,
81 return STATUS_INSUFFICIENT_RESOURCES
;
83 if (!NT_SUCCESS(Status
))
85 ExFreePoolWithTag(pRet
, USERTAG_KBDTABLE
);
89 *ppIndicatorTrans
= pRet
;
94 * IntKeyboardUpdateLeds
96 * Sends the keyboard commands to turn on/off the lights
100 IntKeyboardUpdateLeds(HANDLE hKeyboardDevice
,
108 IO_STATUS_BLOCK Block
;
110 if (!gpKeyboardIndicatorTrans
)
111 return STATUS_NOT_SUPPORTED
;
115 case VK_CAPITAL
: LedFlag
= KEYBOARD_CAPS_LOCK_ON
; break;
116 case VK_NUMLOCK
: LedFlag
= KEYBOARD_NUM_LOCK_ON
; break;
117 case VK_SCROLL
: LedFlag
= KEYBOARD_SCROLL_LOCK_ON
; break;
119 for (i
= 0; i
< gpKeyboardIndicatorTrans
->NumberOfIndicatorKeys
; i
++)
121 if (gpKeyboardIndicatorTrans
->IndicatorList
[i
].MakeCode
== wScanCode
)
123 LedFlag
= gpKeyboardIndicatorTrans
->IndicatorList
[i
].IndicatorFlags
;
132 gIndicators
.LedFlags
|= LedFlag
;
134 gIndicators
.LedFlags
= ~LedFlag
;
136 /* Update the lights on the hardware */
137 Status
= NtDeviceIoControlFile(hKeyboardDevice
,
142 IOCTL_KEYBOARD_SET_INDICATORS
,
143 &gIndicators
, sizeof(gIndicators
),
149 return STATUS_SUCCESS
;
155 * Initializes keyboard indicators translation and their state
158 UserInitKeyboard(HANDLE hKeyboardDevice
)
161 IO_STATUS_BLOCK Block
;
163 IntKeyboardGetIndicatorTrans(hKeyboardDevice
, &gpKeyboardIndicatorTrans
);
165 Status
= NtDeviceIoControlFile(hKeyboardDevice
,
170 IOCTL_KEYBOARD_QUERY_INDICATORS
,
172 &gIndicators
, sizeof(gIndicators
));
174 if (!NT_SUCCESS(Status
))
176 WARN("NtDeviceIoControlFile() failed, ignored\n");
179 SET_KEY_LOCKED(gafAsyncKeyState
, VK_CAPITAL
,
180 gIndicators
.LedFlags
& KEYBOARD_CAPS_LOCK_ON
);
181 SET_KEY_LOCKED(gafAsyncKeyState
, VK_NUMLOCK
,
182 gIndicators
.LedFlags
& KEYBOARD_NUM_LOCK_ON
);
183 SET_KEY_LOCKED(gafAsyncKeyState
, VK_SCROLL
,
184 gIndicators
.LedFlags
& KEYBOARD_SCROLL_LOCK_ON
);
190 * Changes virtual keys which distinguish between left and right hand, to keys which don't distinguish
194 IntSimplifyVk(WORD wVk
)
218 * Changes virtual keys which don't not distinguish between left and right hand to proper keys
222 IntFixVk(WORD wVk
, BOOL bExt
)
227 return bExt
? VK_RSHIFT
: VK_LSHIFT
;
230 return bExt
? VK_RCONTROL
: VK_LCONTROL
;
233 return bExt
? VK_RMENU
: VK_LMENU
;
241 * IntTranslateNumpadKey
243 * Translates numpad keys when numlock is enabled
247 IntTranslateNumpadKey(WORD wVk
)
251 case VK_INSERT
: return VK_NUMPAD0
;
252 case VK_END
: return VK_NUMPAD1
;
253 case VK_DOWN
: return VK_NUMPAD2
;
254 case VK_NEXT
: return VK_NUMPAD3
;
255 case VK_LEFT
: return VK_NUMPAD4
;
256 case VK_CLEAR
: return VK_NUMPAD5
;
257 case VK_RIGHT
: return VK_NUMPAD6
;
258 case VK_HOME
: return VK_NUMPAD7
;
259 case VK_UP
: return VK_NUMPAD8
;
260 case VK_PRIOR
: return VK_NUMPAD9
;
261 case VK_DELETE
: return VK_DECIMAL
;
269 * Gets layout specific modification bits, for example KBDSHIFT, KBDCTRL, KBDALT
273 IntGetModBits(PKBDTABLES pKbdTbl
, PBYTE pKeyState
)
275 DWORD i
, dwModBits
= 0;
277 /* DumpKeyState( KeyState ); */
279 for (i
= 0; pKbdTbl
->pCharModifiers
->pVkToBit
[i
].Vk
; i
++)
280 if (IS_KEY_DOWN(pKeyState
, pKbdTbl
->pCharModifiers
->pVkToBit
[i
].Vk
))
281 dwModBits
|= pKbdTbl
->pCharModifiers
->pVkToBit
[i
].ModBits
;
283 TRACE("Current Mod Bits: %lx\n", dwModBits
);
291 * Translates virtual key to character
295 IntTranslateChar(WORD wVirtKey
,
299 PWCHAR pwcTranslatedChar
,
302 PVK_TO_WCHAR_TABLE pVkToVchTbl
;
303 PVK_TO_WCHARS10 pVkToVch
;
304 DWORD i
, dwModBits
, dwVkModBits
, dwModNumber
= 0;
309 dwModBits
= pKeyState
? IntGetModBits(pKbdTbl
, pKeyState
) : 0;
310 bAltGr
= pKeyState
&& (pKbdTbl
->fLocaleFlags
& KLLF_ALTGR
) && IS_KEY_DOWN(pKeyState
, VK_RMENU
);
311 wCaplokAttr
= bAltGr
? CAPLOKALTGR
: CAPLOK
;
313 TRACE("TryToTranslate: %04x %x\n", wVirtKey
, dwModBits
);
315 /* If ALT without CTRL has ben used, remove ALT flag */
316 if ((dwModBits
& (KBDALT
|KBDCTRL
)) == KBDALT
)
317 dwModBits
&= ~KBDALT
;
319 if (dwModBits
> pKbdTbl
->pCharModifiers
->wMaxModBits
)
321 TRACE("dwModBits %x > wMaxModBits %x\n", dwModBits
, pKbdTbl
->pCharModifiers
->wMaxModBits
);
325 for (i
= 0; pKbdTbl
->pVkToWcharTable
[i
].pVkToWchars
; i
++)
327 pVkToVchTbl
= &pKbdTbl
->pVkToWcharTable
[i
];
328 pVkToVch
= (PVK_TO_WCHARS10
)(pVkToVchTbl
->pVkToWchars
);
329 while (pVkToVch
->VirtualKey
)
331 if (wVirtKey
== (pVkToVch
->VirtualKey
& 0xFF))
333 dwVkModBits
= dwModBits
;
335 /* If CapsLock is enabled for this key and locked, add SHIFT bit */
336 if ((pVkToVch
->Attributes
& wCaplokAttr
) &&
338 IS_KEY_LOCKED(pKeyState
, VK_CAPITAL
))
340 /* Note: we use special value here instead of getting VK_SHIFT mod bit - it's verified */
341 dwVkModBits
^= KBDSHIFT
;
344 if (dwVkModBits
> pKbdTbl
->pCharModifiers
->wMaxModBits
)
347 /* Get modification number */
348 dwModNumber
= pKbdTbl
->pCharModifiers
->ModNumber
[dwVkModBits
];
349 if (dwModNumber
>= pVkToVchTbl
->nModifications
)
351 TRACE("dwModNumber %u >= nModifications %u\n", dwModNumber
, pVkToVchTbl
->nModifications
);
356 wch
= pVkToVch
->wch
[dwModNumber
];
360 *pbDead
= (wch
== WCH_DEAD
);
361 *pbLigature
= (wch
== WCH_LGTR
);
362 *pwcTranslatedChar
= wch
;
364 TRACE("%d %04x: dwModNumber %08x Char %04x\n",
365 i
, wVirtKey
, dwModNumber
, wch
);
369 /* After WCH_DEAD, real character is located */
370 pVkToVch
= (PVK_TO_WCHARS10
)(((BYTE
*)pVkToVch
) + pVkToVchTbl
->cbSize
);
371 if (pVkToVch
->VirtualKey
!= 0xFF)
373 WARN("Found dead key with no trailer in the table.\n");
374 WARN("VK: %04x, ADDR: %p\n", wVirtKey
, pVkToVch
);
377 *pwcTranslatedChar
= pVkToVch
->wch
[dwModNumber
];
381 pVkToVch
= (PVK_TO_WCHARS10
)(((BYTE
*)pVkToVch
) + pVkToVchTbl
->cbSize
);
385 /* If nothing has been found in layout, check if this is ASCII control character.
386 Note: we could add it to layout table, but windows does not have it there */
387 if (wVirtKey
>= 'A' && wVirtKey
<= 'Z' &&
388 pKeyState
&& IS_KEY_DOWN(pKeyState
, VK_CONTROL
) &&
389 !IS_KEY_DOWN(pKeyState
, VK_MENU
))
391 *pwcTranslatedChar
= (wVirtKey
- 'A') + 1; /* ASCII control character */
403 * Translates virtual key to characters
407 IntToUnicodeEx(UINT wVirtKey
,
415 WCHAR wchTranslatedChar
;
416 BOOL bDead
, bLigature
;
417 static WCHAR wchDead
= 0;
422 if (!IntTranslateChar(wVirtKey
,
434 WARN("Not handling ligature (yet)\n" );
438 /* If we got dead char in previous call check dead keys in keyboard layout */
442 WCHAR wchFirst
, wchSecond
;
443 TRACE("Previous dead char: %lc (%x)\n", wchDead
, wchDead
);
445 for (i
= 0; pKbdTbl
->pDeadKey
[i
].dwBoth
; i
++)
447 wchFirst
= pKbdTbl
->pDeadKey
[i
].dwBoth
>> 16;
448 wchSecond
= pKbdTbl
->pDeadKey
[i
].dwBoth
& 0xFFFF;
449 if (wchFirst
== wchDead
&& wchSecond
== wchTranslatedChar
)
451 wchTranslatedChar
= pKbdTbl
->pDeadKey
[i
].wchComposed
;
458 TRACE("Final char: %lc (%x)\n", wchTranslatedChar
, wchTranslatedChar
);
461 /* Dead char has not been not found */
464 /* Treat both characters normally */
466 pwszBuff
[iRet
++] = wchDead
;
470 /* Add character to the buffer */
472 pwszBuff
[iRet
++] = wchTranslatedChar
;
474 /* Save dead character */
475 wchDead
= bDead
? wchTranslatedChar
: 0;
477 return bDead
? -iRet
: iRet
;
483 * Translates virtual key to scan code
487 IntVkToVsc(WORD wVk
, PKBDTABLES pKbdTbl
)
493 /* Check standard keys first */
494 for (i
= 0; i
< pKbdTbl
->bMaxVSCtoVK
; i
++)
496 if ((pKbdTbl
->pusVSCtoVK
[i
] & 0xFF) == wVk
)
500 /* Check extended keys now */
501 for (i
= 0; pKbdTbl
->pVSCtoVK_E0
[i
].Vsc
; i
++)
503 if ((pKbdTbl
->pVSCtoVK_E0
[i
].Vk
& 0xFF) == wVk
)
504 return 0xE000 | pKbdTbl
->pVSCtoVK_E0
[i
].Vsc
;
507 for (i
= 0; pKbdTbl
->pVSCtoVK_E1
[i
].Vsc
; i
++)
509 if ((pKbdTbl
->pVSCtoVK_E1
[i
].Vk
& 0xFF) == wVk
)
510 return 0xE100 | pKbdTbl
->pVSCtoVK_E1
[i
].Vsc
;
513 /* Virtual key has not been found */
520 * Translates prefixed scancode to virtual key
524 IntVscToVk(WORD wScanCode
, PKBDTABLES pKbdTbl
)
531 if ((wScanCode
& 0xFF00) == 0xE000)
533 for (i
= 0; pKbdTbl
->pVSCtoVK_E0
[i
].Vsc
; i
++)
535 if (pKbdTbl
->pVSCtoVK_E0
[i
].Vsc
== (wScanCode
& 0xFF))
537 wVk
= pKbdTbl
->pVSCtoVK_E0
[i
].Vk
;
541 else if ((wScanCode
& 0xFF00) == 0xE100)
543 for (i
= 0; pKbdTbl
->pVSCtoVK_E1
[i
].Vsc
; i
++)
545 if (pKbdTbl
->pVSCtoVK_E1
[i
].Vsc
== (wScanCode
& 0xFF))
547 wVk
= pKbdTbl
->pVSCtoVK_E1
[i
].Vk
;
551 else if (wScanCode
< pKbdTbl
->bMaxVSCtoVK
)
553 wVk
= pKbdTbl
->pusVSCtoVK
[wScanCode
];
556 /* 0xFF nad 0x00 are invalid VKs */
557 return wVk
!= 0xFF ? wVk
: 0;
563 * Translates virtual key to character, ignoring shift state
567 IntVkToChar(WORD wVk
, PKBDTABLES pKbdTbl
)
570 BOOL bDead
, bLigature
;
574 if (IntTranslateChar(wVk
,
588 * NtUserGetAsyncKeyState
590 * Gets key state from global bitmap
594 NtUserGetAsyncKeyState(INT Key
)
598 TRACE("Enter NtUserGetAsyncKeyState\n");
602 EngSetLastError(ERROR_INVALID_PARAMETER
);
603 ERR("Invalid parameter Key\n");
607 UserEnterExclusive();
609 if (IS_KEY_DOWN(gafAsyncKeyState
, Key
))
610 wRet
|= 0x8000; // If down, windows returns 0x8000.
611 if (gafAsyncKeyStateRecentDown
[Key
/ 8] & (1 << (Key
% 8)))
613 gafAsyncKeyStateRecentDown
[Key
/ 8] &= ~(1 << (Key
% 8));
617 TRACE("Leave NtUserGetAsyncKeyState, ret=%i\n", wRet
);
622 * UpdateAsyncKeyState
624 * Updates gafAsyncKeyState array
628 UpdateAsyncKeyState(WORD wVk
, BOOL bIsDown
)
632 /* If it's first key down event, xor lock bit */
633 if (!IS_KEY_DOWN(gafAsyncKeyState
, wVk
))
634 SET_KEY_LOCKED(gafAsyncKeyState
, wVk
, !IS_KEY_LOCKED(gafAsyncKeyState
, wVk
));
636 SET_KEY_DOWN(gafAsyncKeyState
, wVk
, TRUE
);
637 gafAsyncKeyStateRecentDown
[wVk
/ 8] |= (1 << (wVk
% 8));
640 SET_KEY_DOWN(gafAsyncKeyState
, wVk
, FALSE
);
644 * co_CallLowLevelKeyboardHook
646 * Calls WH_KEYBOARD_LL hook
649 co_CallLowLevelKeyboardHook(WORD wVk
, WORD wScanCode
, DWORD dwFlags
, BOOL bInjected
, DWORD dwTime
, DWORD dwExtraInfo
)
651 KBDLLHOOKSTRUCT KbdHookData
;
654 KbdHookData
.vkCode
= wVk
;
655 KbdHookData
.scanCode
= wScanCode
;
656 KbdHookData
.flags
= 0;
657 if (dwFlags
& KEYEVENTF_EXTENDEDKEY
)
658 KbdHookData
.flags
|= LLKHF_EXTENDED
;
659 if (IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
))
660 KbdHookData
.flags
|= LLKHF_ALTDOWN
;
661 if (dwFlags
& KEYEVENTF_KEYUP
)
662 KbdHookData
.flags
|= LLKHF_UP
;
664 KbdHookData
.flags
|= LLKHF_INJECTED
;
665 KbdHookData
.time
= dwTime
;
666 KbdHookData
.dwExtraInfo
= dwExtraInfo
;
668 /* Note: it doesnt support WM_SYSKEYUP */
669 if (dwFlags
& KEYEVENTF_KEYUP
)
671 else if (IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
) && !IS_KEY_DOWN(gafAsyncKeyState
, VK_CONTROL
))
672 uMsg
= WM_SYSKEYDOWN
;
676 return co_HOOK_CallHooks(WH_KEYBOARD_LL
, HC_ACTION
, uMsg
, (LPARAM
)&KbdHookData
);
682 * Saves snapshot of specified window or whole screen in the clipboard
685 SnapWindow(HWND hWnd
)
687 HBITMAP hbm
= NULL
, hbmOld
;
688 HDC hdc
= NULL
, hdcMem
;
693 TRACE("SnapWindow(%p)\n", hWnd
);
695 /* If no windows is given, make snapshot of desktop window */
697 hWnd
= IntGetDesktopWindow();
699 pWnd
= UserGetWindowObject(hWnd
);
702 ERR("Invalid window\n");
706 hdc
= UserGetDCEx(pWnd
, NULL
, DCX_USESTYLE
| DCX_WINDOW
);
709 ERR("UserGetDCEx failed!\n");
713 cx
= pWnd
->rcWindow
.right
- pWnd
->rcWindow
.left
;
714 cy
= pWnd
->rcWindow
.bottom
- pWnd
->rcWindow
.top
;
716 hbm
= NtGdiCreateCompatibleBitmap(hdc
, cx
, cy
);
719 ERR("NtGdiCreateCompatibleBitmap failed!\n");
723 hdcMem
= NtGdiCreateCompatibleDC(hdc
);
726 ERR("NtGdiCreateCompatibleDC failed!\n");
730 hbmOld
= NtGdiSelectBitmap(hdcMem
, hbm
);
731 NtGdiBitBlt(hdcMem
, 0, 0, cx
, cy
, hdc
, 0, 0, SRCCOPY
, 0, 0);
732 NtGdiSelectBitmap(hdcMem
, hbmOld
);
733 IntGdiDeleteDC(hdcMem
, FALSE
);
735 /* Save snapshot in clipboard */
736 if (UserOpenClipboard(NULL
))
738 UserEmptyClipboard();
739 scd
.fIncSerialNumber
= TRUE
;
740 scd
.fGlobalHandle
= FALSE
;
741 if (UserSetClipboardData(CF_BITMAP
, hbm
, &scd
))
743 /* Bitmap is managed by system now */
746 UserCloseClipboard();
751 GreDeleteObject(hbm
);
753 UserReleaseDC(pWnd
, hdc
, FALSE
);
757 * UserSendKeyboardInput
759 * Process keyboard input from input devices and SendInput API
762 ProcessKeyEvent(WORD wVk
, WORD wScanCode
, DWORD dwFlags
, BOOL bInjected
, DWORD dwTime
, DWORD dwExtraInfo
)
764 WORD wSimpleVk
= 0, wFixedVk
, wVk2
;
765 PUSER_MESSAGE_QUEUE pFocusQueue
;
767 BOOL bExt
= (dwFlags
& KEYEVENTF_EXTENDEDKEY
) ? TRUE
: FALSE
;
768 BOOL bIsDown
= (dwFlags
& KEYEVENTF_KEYUP
) ? FALSE
: TRUE
;
769 BOOL bPacket
= (dwFlags
& KEYEVENTF_UNICODE
) ? TRUE
: FALSE
;
770 BOOL bWasSimpleDown
= FALSE
, bPostMsg
= TRUE
, bIsSimpleDown
;
772 static BOOL bMenuDownRecently
= FALSE
;
774 /* Get virtual key without shifts (VK_(L|R)* -> VK_*) */
775 wSimpleVk
= IntSimplifyVk(wVk
);
776 bWasSimpleDown
= IS_KEY_DOWN(gafAsyncKeyState
, wSimpleVk
);
778 /* Update key without shifts */
779 wVk2
= IntFixVk(wSimpleVk
, !bExt
);
780 bIsSimpleDown
= bIsDown
|| IS_KEY_DOWN(gafAsyncKeyState
, wVk2
);
781 UpdateAsyncKeyState(wSimpleVk
, bIsSimpleDown
);
785 /* Update keyboard LEDs */
786 IntKeyboardUpdateLeds(ghKeyboardDevice
,
789 IS_KEY_LOCKED(gafAsyncKeyState
, wSimpleVk
));
792 /* Call WH_KEYBOARD_LL hook */
793 if (co_CallLowLevelKeyboardHook(wVk
, wScanCode
, dwFlags
, bInjected
, dwTime
, dwExtraInfo
))
795 ERR("Kbd msg dropped by WH_KEYBOARD_LL hook\n");
799 /* Check if this is a hotkey */
800 if (co_UserProcessHotKeys(wSimpleVk
, bIsDown
))
803 wFixedVk
= IntFixVk(wSimpleVk
, bExt
); /* LSHIFT + EXT = RSHIFT */
804 if (wSimpleVk
== VK_SHIFT
) /* shift can't be extended */
807 /* If we have a focus queue, post a keyboard message */
808 pFocusQueue
= IntGetFocusMessageQueue();
809 TRACE("ProcessKeyEvent Q 0x%p Active pWnd 0x%p Focus pWnd 0x%p\n",
811 (pFocusQueue
? pFocusQueue
->spwndActive
: 0),
812 (pFocusQueue
? pFocusQueue
->spwndFocus
: 0));
814 /* If it is F10 or ALT is down and CTRL is up, it's a system key */
815 if ( wVk
== VK_F10
||
816 (wSimpleVk
== VK_MENU
&& bMenuDownRecently
) ||
817 (IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
) &&
818 !IS_KEY_DOWN(gafAsyncKeyState
, VK_CONTROL
)) ||
819 // See MSDN WM_SYSKEYDOWN/UP fixes last wine Win test_keyboard_input.
820 (pFocusQueue
&& !pFocusQueue
->spwndFocus
) )
822 bMenuDownRecently
= FALSE
; // reset
825 Msg
.message
= WM_SYSKEYDOWN
;
826 if (wSimpleVk
== VK_MENU
)
828 // Note: If only LALT is pressed WM_SYSKEYUP is generated instead of WM_KEYUP
829 bMenuDownRecently
= TRUE
;
833 Msg
.message
= WM_SYSKEYUP
;
838 Msg
.message
= WM_KEYDOWN
;
840 Msg
.message
= WM_KEYUP
;
843 /* Update async state of not simplified vk here.
844 See user32_apitest:GetKeyState */
845 UpdateAsyncKeyState(wFixedVk
, bIsDown
);
847 /* Alt-Tab/Esc Check. Use FocusQueue or RIT Queue */
848 if (bIsSimpleDown
&& !bWasSimpleDown
&&
849 IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
) &&
850 !IS_KEY_DOWN(gafAsyncKeyState
, VK_CONTROL
) &&
851 (wVk
== VK_ESCAPE
|| wVk
== VK_TAB
))
853 TRACE("Alt-Tab/Esc Pressed wParam %x\n",wVk
);
856 if (bIsDown
&& wVk
== VK_SNAPSHOT
)
859 IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
) &&
860 !IS_KEY_DOWN(gafAsyncKeyState
, VK_CONTROL
))
862 // Snap from Active Window, Focus can be null.
863 SnapWindow(pFocusQueue
->spwndActive
? UserHMGetHandle(pFocusQueue
->spwndActive
) : 0);
866 SnapWindow(NULL
); // Snap Desktop.
868 else if (pFocusQueue
&& bPostMsg
)
870 PWND Wnd
= pFocusQueue
->spwndFocus
;
873 // Focus can be null so going with Active. WM_SYSKEYXXX last wine Win test_keyboard_input.
874 Wnd
= pFocusQueue
->spwndActive
;
877 if ( !Wnd
|| Wnd
->state2
& WNDS2_INDESTROY
|| Wnd
->state
& WNDS_DESTROYED
)
879 ERR("ProcessKeyEvent Active Focus window is dead!\n");
886 Msg
.hwnd
= UserHMGetHandle(Wnd
);
887 Msg
.wParam
= wFixedVk
& 0xFF; /* Note: It's simplified by msg queue */
888 Msg
.lParam
= MAKELPARAM(1, wScanCode
);
890 Msg
.pt
= gpsi
->ptCursor
;
892 /* If it is VK_PACKET, high word of wParam is used for wchar */
896 Msg
.lParam
|= KF_EXTENDED
<< 16;
897 if (IS_KEY_DOWN(gafAsyncKeyState
, VK_MENU
))
898 Msg
.lParam
|= KF_ALTDOWN
<< 16;
900 Msg
.lParam
|= KF_REPEAT
<< 16;
902 Msg
.lParam
|= KF_UP
<< 16;
903 /* FIXME: Set KF_DLGMODE and KF_MENUMODE when needed */
904 if (pFocusQueue
->QF_flags
& QF_DIALOGACTIVE
)
905 Msg
.lParam
|= KF_DLGMODE
<< 16;
906 if (pFocusQueue
->MenuOwner
) // pFocusQueue->MenuState) // MenuState needs a start flag...
907 Msg
.lParam
|= KF_MENUMODE
<< 16;
910 /* Post a keyboard message */
911 TRACE("Posting keyboard msg %u wParam 0x%x lParam 0x%x\n", Msg
.message
, Msg
.wParam
, Msg
.lParam
);
912 MsqPostMessage(pti
, &Msg
, TRUE
, QS_KEY
, 0);
919 UserSendKeyboardInput(KEYBDINPUT
*pKbdInput
, BOOL bInjected
)
924 PUSER_MESSAGE_QUEUE pFocusQueue
;
925 LARGE_INTEGER LargeTickCount
;
927 BOOL bExt
= (pKbdInput
->dwFlags
& KEYEVENTF_EXTENDEDKEY
) ? TRUE
: FALSE
;
929 gppiInputProvider
= ((PTHREADINFO
)PsGetCurrentThreadWin32Thread())->ppi
;
931 /* Find the target thread whose locale is in effect */
932 pFocusQueue
= IntGetFocusMessageQueue();
934 if (pFocusQueue
&& pFocusQueue
->ptiOwner
)
936 pKl
= pFocusQueue
->ptiOwner
->KeyboardLayout
;
940 pKl
= W32kGetDefaultKeyLayout();
943 ERR("No keyboard layout!\n");
947 pKbdTbl
= pKl
->spkf
->pKbdTbl
;
949 /* Note: wScan field is always used */
950 wScanCode
= pKbdInput
->wScan
;
952 if (pKbdInput
->dwFlags
& KEYEVENTF_UNICODE
)
954 /* Generate WM_KEYDOWN msg with wParam == VK_PACKET and
955 high order word of lParam == pKbdInput->wScan */
961 if (pKbdInput
->dwFlags
& KEYEVENTF_SCANCODE
)
963 /* Don't ignore invalid scan codes */
964 wVk
= IntVscToVk(wScanCode
| (bExt
? 0xE000 : 0), pKbdTbl
);
965 if (!wVk
) /* use 0xFF if vsc is invalid */
970 wVk
= pKbdInput
->wVk
& 0xFF;
974 /* If time is given, use it */
976 dwTime
= pKbdInput
->time
;
979 KeQueryTickCount(&LargeTickCount
);
980 dwTime
= MsqCalculateMessageTime(&LargeTickCount
);
983 if (wVk
== VK_RMENU
&& (pKbdTbl
->fLocaleFlags
& KLLF_ALTGR
))
985 /* For AltGr keyboards RALT generates CTRL events */
986 ProcessKeyEvent(VK_LCONTROL
, 0, pKbdInput
->dwFlags
& KEYEVENTF_KEYUP
, bInjected
, dwTime
, 0);
989 /* Finally process this key */
990 return ProcessKeyEvent(wVk
, wScanCode
, pKbdInput
->dwFlags
, bInjected
, dwTime
, pKbdInput
->dwExtraInfo
);
994 * UserProcessKeyboardInput
996 * Process raw keyboard input data
999 UserProcessKeyboardInput(
1000 PKEYBOARD_INPUT_DATA pKbdInputData
)
1002 WORD wScanCode
, wVk
;
1005 PUSER_MESSAGE_QUEUE pFocusQueue
;
1007 /* Calculate scan code with prefix */
1008 wScanCode
= pKbdInputData
->MakeCode
& 0x7F;
1009 if (pKbdInputData
->Flags
& KEY_E0
)
1010 wScanCode
|= 0xE000;
1011 if (pKbdInputData
->Flags
& KEY_E1
)
1012 wScanCode
|= 0xE100;
1014 /* Find the target thread whose locale is in effect */
1015 pFocusQueue
= IntGetFocusMessageQueue();
1017 if (pFocusQueue
&& pFocusQueue
->ptiOwner
)
1019 pKl
= pFocusQueue
->ptiOwner
->KeyboardLayout
;
1023 pKl
= W32kGetDefaultKeyLayout();
1027 pKbdTbl
= pKl
->spkf
->pKbdTbl
;
1029 /* Convert scan code to virtual key.
1030 Note: We could call UserSendKeyboardInput using scan code,
1031 but it wouldn't interpret E1 key(s) properly */
1032 wVk
= IntVscToVk(wScanCode
, pKbdTbl
);
1033 TRACE("UserProcessKeyboardInput: %x (break: %u) -> %x\n",
1034 wScanCode
, (pKbdInputData
->Flags
& KEY_BREAK
) ? 1 : 0, wVk
);
1038 KEYBDINPUT KbdInput
;
1040 /* Support numlock */
1041 if ((wVk
& KBDNUMPAD
) && IS_KEY_LOCKED(gafAsyncKeyState
, VK_NUMLOCK
))
1043 wVk
= IntTranslateNumpadKey(wVk
& 0xFF);
1046 /* Send keyboard input */
1047 KbdInput
.wVk
= wVk
& 0xFF;
1048 KbdInput
.wScan
= wScanCode
& 0x7F;
1049 KbdInput
.dwFlags
= 0;
1050 if (pKbdInputData
->Flags
& KEY_BREAK
)
1051 KbdInput
.dwFlags
|= KEYEVENTF_KEYUP
;
1053 KbdInput
.dwFlags
|= KEYEVENTF_EXTENDEDKEY
;
1055 KbdInput
.dwExtraInfo
= pKbdInputData
->ExtraInformation
;
1056 UserSendKeyboardInput(&KbdInput
, FALSE
);
1058 /* E1 keys don't have break code */
1059 if (pKbdInputData
->Flags
& KEY_E1
)
1061 /* Send key up event */
1062 KbdInput
.dwFlags
|= KEYEVENTF_KEYUP
;
1063 UserSendKeyboardInput(&KbdInput
, FALSE
);
1069 * IntTranslateKbdMessage
1071 * Addes WM_(SYS)CHAR messages to message queue if message
1072 * describes key which produce character.
1075 IntTranslateKbdMessage(LPMSG lpMsg
,
1080 WCHAR wch
[3] = { 0 };
1083 LARGE_INTEGER LargeTickCount
;
1084 BOOL bResult
= FALSE
;
1086 switch(lpMsg
->message
)
1097 pti
= PsGetCurrentThreadWin32Thread();
1099 if (!pti
->KeyboardLayout
)
1101 pti
->KeyboardLayout
= W32kGetDefaultKeyLayout();
1102 pti
->pClientInfo
->hKL
= pti
->KeyboardLayout
? pti
->KeyboardLayout
->hkl
: NULL
;
1103 pKbdTbl
= pti
->KeyboardLayout
? pti
->KeyboardLayout
->spkf
->pKbdTbl
: NULL
;
1106 pKbdTbl
= pti
->KeyboardLayout
->spkf
->pKbdTbl
;
1110 if (lpMsg
->message
!= WM_KEYDOWN
&& lpMsg
->message
!= WM_SYSKEYDOWN
)
1113 /* Init pt, hwnd and time msg fields */
1114 NewMsg
.pt
= gpsi
->ptCursor
;
1115 NewMsg
.hwnd
= lpMsg
->hwnd
;
1116 KeQueryTickCount(&LargeTickCount
);
1117 NewMsg
.time
= MsqCalculateMessageTime(&LargeTickCount
);
1119 TRACE("Enter IntTranslateKbdMessage msg %s, vk %x\n",
1120 lpMsg
->message
== WM_SYSKEYDOWN
? "WM_SYSKEYDOWN" : "WM_KEYDOWN", lpMsg
->wParam
);
1122 if (lpMsg
->wParam
== VK_PACKET
)
1124 NewMsg
.message
= (lpMsg
->message
== WM_KEYDOWN
) ? WM_CHAR
: WM_SYSCHAR
;
1125 NewMsg
.wParam
= HIWORD(lpMsg
->lParam
);
1126 NewMsg
.lParam
= LOWORD(lpMsg
->lParam
);
1127 MsqPostMessage(pti
, &NewMsg
, FALSE
, QS_KEY
, 0);
1131 cch
= IntToUnicodeEx(lpMsg
->wParam
,
1132 HIWORD(lpMsg
->lParam
) & 0xFF,
1133 pti
->MessageQueue
->afKeyState
,
1135 sizeof(wch
) / sizeof(wch
[0]),
1141 if (cch
> 0) /* Normal characters */
1142 NewMsg
.message
= (lpMsg
->message
== WM_KEYDOWN
) ? WM_CHAR
: WM_SYSCHAR
;
1143 else /* Dead character */
1147 (lpMsg
->message
== WM_KEYDOWN
) ? WM_DEADCHAR
: WM_SYSDEADCHAR
;
1149 NewMsg
.lParam
= lpMsg
->lParam
;
1151 /* Send all characters */
1152 for (i
= 0; i
< cch
; ++i
)
1154 TRACE("Msg: %x '%lc' (%04x) %08x\n", NewMsg
.message
, wch
[i
], wch
[i
], NewMsg
.lParam
);
1155 NewMsg
.wParam
= wch
[i
];
1156 MsqPostMessage(pti
, &NewMsg
, FALSE
, QS_KEY
, 0);
1161 TRACE("Leave IntTranslateKbdMessage ret %u, cch %d, msg %x, wch %x\n",
1162 bResult
, cch
, NewMsg
.message
, NewMsg
.wParam
);
1167 * Map a virtual key code, or virtual scan code, to a scan code, key code,
1168 * or unshifted unicode character.
1172 * 0 -- Code is a virtual key code that is converted into a virtual scan code
1173 * that does not distinguish between left and right shift keys.
1174 * 1 -- Code is a virtual scan code that is converted into a virtual key code
1175 * that does not distinguish between left and right shift keys.
1176 * 2 -- Code is a virtual key code that is converted into an unshifted unicode
1178 * 3 -- Code is a virtual scan code that is converted into a virtual key code
1179 * that distinguishes left and right shift keys.
1180 * KeyLayout: Keyboard layout handle
1185 IntMapVirtualKeyEx(UINT uCode
, UINT Type
, PKBDTABLES pKbdTbl
)
1191 case MAPVK_VK_TO_VSC
:
1192 uCode
= IntFixVk(uCode
, FALSE
);
1193 uRet
= IntVkToVsc(uCode
, pKbdTbl
);
1194 if (uRet
> 0xFF) // Fail for scancodes with prefix (e0, e1)
1198 case MAPVK_VSC_TO_VK
:
1199 uRet
= IntVscToVk(uCode
, pKbdTbl
) & 0xFF;
1200 uRet
= IntSimplifyVk(uRet
);
1203 case MAPVK_VK_TO_CHAR
:
1204 uRet
= (UINT
)IntVkToChar(uCode
, pKbdTbl
);
1207 case MAPVK_VSC_TO_VK_EX
:
1208 uRet
= IntVscToVk(uCode
, pKbdTbl
) & 0xFF;
1211 case MAPVK_VK_TO_VSC_EX
:
1212 uRet
= IntVkToVsc(uCode
, pKbdTbl
);
1216 EngSetLastError(ERROR_INVALID_PARAMETER
);
1217 ERR("Wrong type value: %u\n", Type
);
1224 * NtUserMapVirtualKeyEx
1226 * Map a virtual key code, or virtual scan code, to a scan code, key code,
1227 * or unshifted unicode character. See IntMapVirtualKeyEx.
1231 NtUserMapVirtualKeyEx(UINT uCode
, UINT uType
, DWORD keyboardId
, HKL dwhkl
)
1233 PKBDTABLES pKbdTbl
= NULL
;
1236 TRACE("Enter NtUserMapVirtualKeyEx\n");
1243 pti
= PsGetCurrentThreadWin32Thread();
1244 if (pti
&& pti
->KeyboardLayout
)
1245 pKbdTbl
= pti
->KeyboardLayout
->spkf
->pKbdTbl
;
1251 pKl
= UserHklToKbl(dwhkl
);
1253 pKbdTbl
= pKl
->spkf
->pKbdTbl
;
1257 ret
= IntMapVirtualKeyEx(uCode
, uType
, pKbdTbl
);
1260 TRACE("Leave NtUserMapVirtualKeyEx, ret=%i\n", ret
);
1267 * Translates virtual key to characters
1274 PBYTE pKeyStateUnsafe
,
1275 LPWSTR pwszBuffUnsafe
,
1281 BYTE afKeyState
[256 * 2 / 8] = {0};
1282 PWCHAR pwszBuff
= NULL
;
1286 TRACE("Enter NtUserSetKeyboardState\n");
1288 /* Return 0 if SC_KEY_UP bit is set */
1289 if (wScanCode
& SC_KEY_UP
|| wVirtKey
>= 0x100)
1291 ERR("Invalid parameter\n");
1297 /* Probe and copy key state to smaller bitmap */
1298 ProbeForRead(pKeyStateUnsafe
, 256 * sizeof(BYTE
), 1);
1299 for (i
= 0; i
< 256; ++i
)
1301 if (pKeyStateUnsafe
[i
] & KS_DOWN_BIT
)
1302 SET_KEY_DOWN(afKeyState
, i
, TRUE
);
1303 if (pKeyStateUnsafe
[i
] & KS_LOCK_BIT
)
1304 SET_KEY_LOCKED(afKeyState
, i
, TRUE
);
1307 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER
)
1309 ERR("Cannot copy key state\n");
1310 SetLastNtError(_SEH2_GetExceptionCode());
1311 _SEH2_YIELD(return 0);
1315 pwszBuff
= ExAllocatePoolWithTag(NonPagedPool
, sizeof(WCHAR
) * cchBuff
, TAG_STRING
);
1318 ERR("ExAllocatePoolWithTag(%d) failed\n", sizeof(WCHAR
) * cchBuff
);
1321 RtlZeroMemory(pwszBuff
, sizeof(WCHAR
) * cchBuff
);
1323 UserEnterExclusive(); // Note: We modify wchDead static variable
1326 pKl
= UserHklToKbl(dwhkl
);
1330 pti
= PsGetCurrentThreadWin32Thread();
1331 pKl
= pti
->KeyboardLayout
;
1334 iRet
= IntToUnicodeEx(wVirtKey
,
1340 pKl
? pKl
->spkf
->pKbdTbl
: NULL
);
1342 MmCopyToCaller(pwszBuffUnsafe
, pwszBuff
, cchBuff
* sizeof(WCHAR
));
1343 ExFreePoolWithTag(pwszBuff
, TAG_STRING
);
1346 TRACE("Leave NtUserSetKeyboardState, ret=%i\n", iRet
);
1351 * NtUserGetKeyNameText
1353 * Gets key name from keyboard layout
1357 NtUserGetKeyNameText(LONG lParam
, LPWSTR lpString
, int cchSize
)
1360 DWORD i
, cchKeyName
, dwRet
= 0;
1361 WORD wScanCode
= (lParam
>> 16) & 0xFF;
1362 BOOL bExtKey
= (HIWORD(lParam
) & KF_EXTENDED
) ? TRUE
: FALSE
;
1364 VSC_LPWSTR
*pKeyNames
= NULL
;
1365 CONST WCHAR
*pKeyName
= NULL
;
1366 WCHAR KeyNameBuf
[2];
1368 TRACE("Enter NtUserGetKeyNameText\n");
1372 /* Get current keyboard layout */
1373 pti
= PsGetCurrentThreadWin32Thread();
1374 pKbdTbl
= pti
? pti
->KeyboardLayout
->spkf
->pKbdTbl
: 0;
1376 if (!pKbdTbl
|| cchSize
< 1)
1378 ERR("Invalid parameter\n");
1382 /* "Do not care" flag */
1383 if(lParam
& LP_DO_NOT_CARE_BIT
)
1385 /* Note: We could do vsc -> vk -> vsc conversion, instead of using
1386 hardcoded scan codes, but it's not what Windows does */
1387 if (wScanCode
== SCANCODE_RSHIFT
&& !bExtKey
)
1388 wScanCode
= SCANCODE_LSHIFT
;
1389 else if (wScanCode
== SCANCODE_CTRL
|| wScanCode
== SCANCODE_ALT
)
1394 pKeyNames
= pKbdTbl
->pKeyNamesExt
;
1396 pKeyNames
= pKbdTbl
->pKeyNames
;
1398 for (i
= 0; pKeyNames
[i
].pwsz
; i
++)
1400 if (pKeyNames
[i
].vsc
== wScanCode
)
1402 pKeyName
= pKeyNames
[i
].pwsz
;
1409 WORD wVk
= IntVscToVk(wScanCode
, pKbdTbl
);
1413 KeyNameBuf
[0] = IntVkToChar(wVk
, pKbdTbl
);
1416 pKeyName
= KeyNameBuf
;
1422 cchKeyName
= wcslen(pKeyName
);
1423 if (cchKeyName
> (cchSize
- 1UL))
1424 cchKeyName
= cchSize
- 1UL; // Don't count '\0'
1428 ProbeForWrite(lpString
, (cchKeyName
+ 1) * sizeof(WCHAR
), 1);
1429 RtlCopyMemory(lpString
, pKeyName
, cchKeyName
* sizeof(WCHAR
));
1430 lpString
[cchKeyName
] = UNICODE_NULL
;
1433 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER
)
1435 SetLastNtError(_SEH2_GetExceptionCode());
1441 EngSetLastError(ERROR_INVALID_PARAMETER
);
1446 TRACE("Leave NtUserGetKeyNameText, ret=%i\n", dwRet
);
1451 * UserGetKeyboardType
1453 * Returns some keyboard specific information
1456 UserGetKeyboardType(
1461 case 0: /* Keyboard type */
1462 return 4; /* AT-101 */
1463 case 1: /* Keyboard Subtype */
1464 return 0; /* There are no defined subtypes */
1465 case 2: /* Number of F-keys */
1466 return 12; /* We're doing an 101 for now, so return 12 F-keys */
1468 ERR("Unknown type!\n");
1469 return 0; /* Note: we don't have to set last error here */
1476 * Based on IntTranslateChar, instead of processing VirtualKey match,
1477 * look for wChar match.
1487 PVK_TO_WCHAR_TABLE pVkToWchTbl
;
1488 PVK_TO_WCHARS10 pVkToWch
;
1490 DWORD i
, dwModBits
= 0, dwModNumber
= 0, Ret
= (DWORD
)-1;
1492 TRACE("NtUserVkKeyScanEx() wch %d, KbdLayout 0x%p\n", wch
, dwhkl
);
1497 // Use given keyboard layout
1499 pKl
= UserHklToKbl(dwhkl
);
1503 // Use thread keyboard layout
1504 pKl
= ((PTHREADINFO
)PsGetCurrentThreadWin32Thread())->KeyboardLayout
;
1510 pKbdTbl
= pKl
->spkf
->pKbdTbl
;
1512 // Interate through all VkToWchar tables while pVkToWchars is not NULL
1513 for (i
= 0; pKbdTbl
->pVkToWcharTable
[i
].pVkToWchars
; i
++)
1515 pVkToWchTbl
= &pKbdTbl
->pVkToWcharTable
[i
];
1516 pVkToWch
= (PVK_TO_WCHARS10
)(pVkToWchTbl
->pVkToWchars
);
1518 // Interate through all virtual keys
1519 while (pVkToWch
->VirtualKey
)
1521 for (dwModNumber
= 0; dwModNumber
< pVkToWchTbl
->nModifications
; dwModNumber
++)
1523 if (pVkToWch
->wch
[dwModNumber
] == wch
)
1525 dwModBits
= pKbdTbl
->pCharModifiers
->ModNumber
[dwModNumber
];
1526 TRACE("i %d wC %04x: dwModBits %08x dwModNumber %08x MaxModBits %08x\n",
1527 i
, wch
, dwModBits
, dwModNumber
, pKbdTbl
->pCharModifiers
->wMaxModBits
);
1528 Ret
= (dwModBits
<< 8) | (pVkToWch
->VirtualKey
& 0xFF);
1532 pVkToWch
= (PVK_TO_WCHARS10
)(((BYTE
*)pVkToWch
) + pVkToWchTbl
->cbSize
);