Obtains the next available keystroke from the specified screen.
#include <screen.h>
int GetRawKeyWithScreen (
scr_t scrID,
uint8_t *type,
uint8_t *value,
uint8_t *status,
uint8_t *scancode );
(IN) Specifies the screen.
(OUT) Specifies the key type. See Section 23.2, Key Types.
(OUT) Points to the ASCII value of the key that was pressed.
(OUT) Points to whether a modifier key was pressed, for example the Shift Key. For a list of possible values, see Section 23.3, Key Status.
(OUT) Points to the codes emitted by the keyboard when a key is pressed.
If successful, returns 0. Otherwise, returns a nonzero error code.
The GetRawKeyWithScreen function handles certain blocking and unblocking events that the GetKey function ignores. For example, GetRawKeyWithScreen knows how to clean up if the thread calling this function is blocked when the owner of the thread is unloaded.