Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The function based on this prototype implements the functionality of MapVirtualKey. It is called by MapVirtualKey, which translates, or maps, a virtual-key code into a scan code or character value, or translates a scan code into a virtual-key code.
typedef UINT32 (*PFN_KEYBD_DRIVER_MAP_VIRTUAL_KEY)( UINT32 uCode, UINT32 uMapType);
Parameters
uCode
[in] Virtual-key code or scan code for a key.uMapType
[in] Translation to perform. The value of this parameter depends on the value of the uCode parameter.The following table shows the possible translations.
Value Description 0 uCode is a virtual-key code that is translated into a scan code. If it is a virtual-key code that does not distinguish between left-hand and right-hand keys, the left-hand scan code is returned. If there is no translation, the function returns zero. 1 uCode is a scan code that is translated into a virtual-key code that does not distinguish between left-hand and right-hand keys. If there is no translation, the function returns zero. 2 uCode is a virtual-key code that is translated into an unshifted character value in the low-order word of the return value. Dead keys, or diacritics, are indicated by setting the top bit of the return value. If there is no translation, the function returns zero. 3 uCode is a scan code that is translated into a virtual-key code that distinguishes between left-hand and right-hand keys. If there is no translation, the function returns zero.
Return Values
A character value indicates success. Zero indicates that there is no translation.
Remarks
Cases 0 and 2 have to do with converting virtual-key codes to Unicode characters or scan codes. Therefore, they use the input language. Cases 1 and 3 convert a scan code to a virtual-key code. As such, they use the current device layout for the first platform dependent driver (PDD) in Layout Manager. Remote Desktop Protocol (RDP) uses translation 0 to convert virtual-key codes to XT scan codes. The human interface device (HID) keyboard driver uses translation 3 to convert AT scan codes to virtual-key codes.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Keybddr.h.
Link Library: LayoutManager.lib.
See Also
Send Feedback on this topic to the authors