translate_message


bool translate_message(const queue_message* queue_message)

This function translates virtual key messages into character messages and posts them to the queue.

Parameters

const queue_message* queue_message

A pointer to the queue message to be translated.

Return

bool

true A virtual key message was translated into a character message.
false No virtual key message was translated.

Notes

When a keyboard key is depressed, the keyboard driver posts the message message::key_down to the queue of the thread that has the input focus. Likewise, when a keyboard key is released, the keyboard driver posts the message message::key_up. This function generates and posts the message message::character on the key down transition.

The message for which this function is called remains unmodified.