Skip to content

FreeRDP3 migration notes

Jump to bottom
Pascal Nowack edited this page Apr 21, 2023 · 4 revisions

This page collects migration notes to port your code from FreeRDP 2 to FreeRDP 3.

Deprecated fields

In rdpSettings

  • After #8046 replace your usage of RdpKeyFile And RdpKeyContent by PrivateKeyFile and PrivateKeyContent

In rdpContext

In rdpRdp

In POINTER_COLOR_UPDATE

xPos has been renamed to hotSpotX and yPos has been renamed to hotSpotY;

Keyboard Input

KEYCODE_TYPE_EVDEV has been renamed to KEYCODE_TYPE_XKB, as it previously actually handled XKB keycodes, instead of evdev keycodes.

If you use GetVirtualKeyCodeFromKeycode() or GetKeycodeFromVirtualKeyCode() in your FreeRDP2 code and used KEYCODE_TYPE_EVDEV for translation between virtual keycodes and XKB keycodes and wish to do that further, change the used keyboard type from KEYCODE_TYPE_EVDEV to KEYCODE_TYPE_XKB.

Additionally, FreeRDP3 now supports actual translation between evdev keycodes and virtual keycodes. If you want to use that translation, use the keyboard type KEYCODE_TYPE_EVDEV.

https://github.com/FreeRDP/FreeRDP.wiki.git

Clone this wiki locally