path: root/backends/wininput.c

#define BACKEND_NAME "wininput"
//#define DEBUG

#include <string.h>
#include "wininput.h"

#include <mmsystem.h>

//TODO check whether feedback elimination is required
//TODO might want to store virtual desktop extents in request->limit

static key_info keys[] = {
	{VK_LBUTTON, "lmb", button}, {VK_RBUTTON, "rmb", button}, {VK_MBUTTON, "mmb", button},
	{VK_XBUTTON1, "xmb1", button}, {VK_XBUTTON2, "xmb2", button},
	{VK_BACK, "backspace"},
	{VK_TAB, "tab"},
	{VK_CLEAR, "clear"},
	{VK_RETURN, "enter"},
	{VK_SHIFT, "shift"},
	{VK_CONTROL, "control"}, {VK_MENU, "alt"},
	{VK_CAPITAL, "capslock"},
	{VK_ESCAPE, "escape"},
	{VK_SPACE, "space"},
	{VK_PRIOR, "pageup"}, {VK_NEXT, "pagedown"},
	{VK_END, "end"}, {VK_HOME, "home"},
	{VK_PAUSE, "pause"}, {VK_NUMLOCK, "numlock"}, {VK_SCROLL, "scrolllock"},
	{VK_INSERT, "insert"}, {VK_DELETE, "delete"}, {VK_SNAPSHOT, "printscreen"},
	{VK_LEFT, "left"}, {VK_UP, "up"}, {VK_RIGHT, "right"}, {VK_DOWN, "down"},
	{VK_SELECT, "select"},
	{VK_PRINT, "print"},
	{VK_EXECUTE, "execute"},
	{VK_HELP, "help"},
	{VK_APPS, "apps"},
	{VK_SLEEP, "sleep"},
	{VK_NUMPAD0, "num0"}, {VK_NUMPAD1, "num1"}, {VK_NUMPAD2, "num2"}, {VK_NUMPAD3, "num3"},
	{VK_NUMPAD4, "num4"}, {VK_NUMPAD5, "num5"}, {VK_NUMPAD6, "num6"}, {VK_NUMPAD7, "num7"},
	{VK_NUMPAD8, "num8"}, {VK_NUMPAD9, "num9"}, {VK_MULTIPLY, "multiply"}, {VK_ADD, "plus"},
	{VK_SEPARATOR, "comma"}, {VK_SUBTRACT, "minus"}, {VK_DECIMAL, "dot"}, {VK_DIVIDE, "divide"},
	{VK_F1, "f1"}, {VK_F2, "f2"}, {VK_F3, "f3"}, {VK_F4, "f4"}, {VK_F5, "f5"},
	{VK_F6, "f6"}, {VK_F7, "f7"}, {VK_F8, "f8"}, {VK_F9, "f9"}, {VK_F10, "f10"},
	{VK_F11, "f11"}, {VK_F12, "f12"}, {VK_F13, "f13"}, {VK_F14, "f14"}, {VK_F15, "f15"},
	{VK_F16, "f16"}, {VK_F17, "f17"}, {VK_F18, "f18"}, {VK_F19, "f19"}, {VK_F20, "f20"},
	{VK_F21, "f21"}, {VK_F22, "f22"}, {VK_F23, "f23"}, {VK_F24, "f24"},
	{VK_LWIN, "lwin"}, {VK_RWIN, "rwin"},
	{VK_LSHIFT, "lshift"}, {VK_RSHIFT, "rshift"},
	{VK_LCONTROL, "lctrl"}, {VK_RCONTROL, "rctrl"},
	{VK_LMENU, "lmenu"}, {VK_RMENU, "rmenu"},
	{VK_BROWSER_BACK, "previous"}, {VK_BROWSER_FORWARD, "next"}, {VK_BROWSER_REFRESH, "refresh"},
	{VK_BROWSER_STOP, "stop"}, {VK_BROWSER_SEARCH, "search"}, {VK_BROWSER_FAVORITES, "favorites"},
	{VK_BROWSER_HOME, "homepage"},
	{VK_VOLUME_MUTE, "mute"}, {VK_VOLUME_DOWN, "voldown"}, {VK_VOLUME_UP, "volup"},
	{VK_MEDIA_NEXT_TRACK, "nexttrack"}, {VK_MEDIA_PREV_TRACK, "prevtrack"},
	{VK_MEDIA_STOP, "stopmedia"}, {VK_MEDIA_PLAY_PAUSE, "togglemedia"},
	{VK_LAUNCH_MEDIA_SELECT, "mediaselect"},
	{VK_LAUNCH_MAIL, "mail"}, {VK_LAUNCH_APP1, "app1"}, {VK_LAUNCH_APP2, "app2"},
	{VK_OEM_PLUS, "plus"}, {VK_OEM_COMMA, "comma"},
	{VK_OEM_MINUS, "minus"}, {VK_OEM_PERIOD, "period"},
	{VK_ZOOM, "zoom"}
};

static struct {
	int virtual_x, virtual_y, virtual_width, virtual_height;
	long mouse_x, mouse_y;
	size_t requests;
	//sorted in _start
	wininput_request* request;
	uint32_t interval;
	uint64_t wheel, wheel_max, wheel_delta;
	uint8_t wheel_inverted;
} cfg = {
	.requests = 0,
	.interval = 50,
	.wheel_max = 0xFFFF,
	.wheel_delta = 1
};

MM_PLUGIN_API int init(){
	backend wininput = {
		.name = BACKEND_NAME,
		.conf = wininput_configure,
		.create = wininput_instance,
		.interval = wininput_interval,
		.conf_instance = wininput_configure_instance,
		.channel = wininput_channel,
		.handle = wininput_set,
		.process = wininput_handle,
		.start = wininput_start,
		.shutdown = wininput_shutdown
	};

	if(sizeof(wininput_channel_ident) != sizeof(uint64_t)){
		LOG("Channel identification union out of bounds");
		return 1;
	}

	//register backend
	if(mm_backend_register(wininput)){
		LOG("Failed to register backend");
		return 1;
	}
	return 0;
}

static int request_comparator(const void * raw_a, const void * raw_b){
	wininput_request* a = (wininput_request*) raw_a, *b = (wininput_request*) raw_b;

	//sort by type first
	if(a->ident.fields.type != b->ident.fields.type){
		return a->ident.fields.type - b->ident.fields.type;
	}

	//joysticks need to be sorted by controller id first so we can query them once
	if(a->ident.fields.type == joystick){
		//joystick id is in the upper bits of control and we don't actually care about anything else
		return a->ident.fields.control - b->ident.fields.control;
	}

	//the rest doesn't actually need to be sorted at all
	return 0;
}

static uint32_t wininput_interval(){
	return cfg.interval;
}

static int wininput_configure(char* option, char* value){
	int64_t parameter = 0;
	char* next_token = NULL;

	if(!strcmp(option, "interval")){
		cfg.interval = strtoul(value, NULL, 0);
		return 0;
	}
	else if(!strcmp(option, "wheel")){
		parameter = strtoll(value, &next_token, 0);

		cfg.wheel_max = parameter;
		if(parameter < 0){
			LOG("Inverting mouse wheel data");
			cfg.wheel_max = -parameter;
			cfg.wheel_inverted = 1;
		}
		else if(!parameter){
			LOGPF("Invalid mouse wheel configuration %s", value);
			return 1;
		}

		if(next_token && *next_token){
			cfg.wheel = strtoul(next_token, NULL, 0);
		}

		if(cfg.wheel > cfg.wheel_max){
			LOG("Mouse wheel initial value out of range");
			return 1;
		}

		return 0;
	}
	else if(!strcmp(option, "wheeldelta")){
		cfg.wheel_delta = strtoul(value, NULL, 0);
		return 0;
	}


	LOGPF("Unknown backend configuration option %s", option);
	return 1;
}

static int wininput_configure_instance(instance* inst, char* option, char* value){
	LOG("The backend does not take any instance configuration");
	return 0;
}

static int wininput_instance(instance* inst){
	return 0;
}

static int wininput_subscribe(uint64_t ident, channel* chan){
	size_t u, n;

	//find an existing request
	for(u = 0; u < cfg.requests; u++){
		if(cfg.request[u].ident.label == ident){
			break;
		}
	}

	if(u == cfg.requests){
		//create a new request
		cfg.request = realloc(cfg.request, (cfg.requests + 1) * sizeof(wininput_request));
		if(!cfg.request){
			cfg.requests = 0;
			LOG("Failed to allocate memory");
			return 1;
		}

		cfg.request[u].ident.label = ident;
		cfg.request[u].channels = 0;
		cfg.request[u].channel = NULL;
		cfg.request[u].state = cfg.request[u].min = cfg.request[u].max = 0;
		cfg.requests++;
	}

	//check if already in subscriber list
	for(n = 0; n < cfg.request[u].channels; n++){
		if(cfg.request[u].channel[n] == chan){
			return 0;
		}
	}

	//add to subscriber list
	cfg.request[u].channel = realloc(cfg.request[u].channel, (cfg.request[u].channels + 1) * sizeof(channel*));
	if(!cfg.request[u].channel){
		cfg.request[u].channels = 0;
		LOG("Failed to allocate memory");
		return 1;
	}
	cfg.request[u].channel[n] = chan;
	cfg.request[u].channels++;
	return 0;
}

static uint64_t wininput_channel_mouse(instance* inst, char* spec, uint8_t flags){
	size_t u;
	wininput_channel_ident ident = {
		.fields.type = mouse
	};

	if(!strcmp(spec, "x")){
		ident.fields.channel = position;
	}
	else if(!strcmp(spec, "y")){
		ident.fields.channel = position;
		ident.fields.control = 1;
	}
	else if(!strcmp(spec, "wheel")){
		ident.fields.channel = wheel;
		if(flags & mmchannel_input){
			LOG("The mouse wheel can only be used as an output channel");
			return 0;
		}
	}
	else{
		//check the buttons
		for(u = 0; u < sizeof(keys) / sizeof(keys[0]); u++){
			if(keys[u].channel == button && !strcmp(keys[u].name, spec)){
				DBGPF("Using keymap %" PRIsize_t " (%d) for spec %s", u, keys[u].keycode, spec);
				ident.fields.channel = button;
				ident.fields.control = keys[u].keycode;
				break;
			}
		}

		if(u == sizeof(keys) / sizeof(keys[0])){
			LOGPF("Unknown mouse control %s", spec);
			return 0;
		}
	}

	return ident.label;
}

static uint64_t wininput_channel_key(instance* inst, char* spec, uint8_t flags){
	size_t u;
	uint16_t scancode = 0;
	wininput_channel_ident ident = {
		.fields.type = keyboard,
		.fields.channel = keypress
	};

	for(u = 0; u < sizeof(keys) / sizeof(keys[0]); u++){
		if(keys[u].channel == keypress && !strcmp(keys[u].name, spec)){
			DBGPF("Using keymap %" PRIsize_t " (%d) for spec %s", u, keys[u].keycode, spec);
			ident.fields.control = keys[u].keycode;
			return ident.label;
		}
	}

	//no entry in translation table
	if(strlen(spec) == 1){
		//try to translate
		scancode = VkKeyScan(spec[0]);
		if(scancode != 0x7f7f){
			DBGPF("Using keyscan result %02X (via %04X) for spec %s", scancode & 0xFF, scancode, spec);
			ident.fields.control = scancode & 0xFF;
			return ident.label;
		}
	}
	else if(strlen(spec) > 1){
		//try to use as literal
		scancode = strtoul(spec, NULL, 0);
		if(scancode){
			DBGPF("Using direct conversion %d for spec %s", scancode & 0xFF, spec);
			ident.fields.control = scancode & 0xFF;
			return ident.label;
		}
	}

	LOGPF("Unknown keyboard control %s", spec);
	return 0;
}

static uint64_t wininput_channel_joystick(instance* inst, char* spec, uint8_t flags){
	char* token = NULL, *axes = "xyzruvp";
	uint16_t controller = strtoul(spec, &token, 0);
	wininput_channel_ident ident = {
		.fields.type = joystick
	};

	if(flags & mmchannel_output){
		LOG("Joystick channels can only be mapped as inputs on Windows");
		return 0;
	}

	if(!controller || !token || *token != '.'){
		LOGPF("Invalid joystick specification %s", spec);
		return 0;
	}
	token++;

	if(strlen(token) == 1 || !strcmp(token, "pov")){
		if(strchr(axes, token[0])){
			ident.fields.channel = position;
			ident.fields.control = ((controller - 1) << 8) | token[0];
			return ident.label;
		}

		LOGPF("Unknown joystick axis specification %s", token);
		return 0;
	}

	if(!strncmp(token, "button", 6)){
		ident.fields.control = strtoul(token + 6, NULL, 10);
		if(!ident.fields.control || ident.fields.control > 32){
			LOGPF("Button index out of range for specification %s", token);
			return 0;
		}
		ident.fields.channel = button;
		ident.fields.control |= (controller << 8);
		return ident.label;
	}

	LOGPF("Invalid joystick control %s", spec);
	return 0;
}

static channel* wininput_channel(instance* inst, char* spec, uint8_t flags){
	channel* chan = NULL;
	uint64_t label = 0;

	if(!strncmp(spec, "mouse.", 6)){
		label = wininput_channel_mouse(inst, spec + 6, flags);
	}
	else if(!strncmp(spec, "key.", 4)){
		label = wininput_channel_key(inst, spec + 4, flags);
	}
	else if(!strncmp(spec, "joy", 3)){
		label = wininput_channel_joystick(inst, spec + 3, flags);
	}
	else{
		LOGPF("Unknown channel spec type %s", spec);
	}

	if(label){
		chan = mm_channel(inst, label, 1);
		if(chan && (flags & mmchannel_input) && wininput_subscribe(label, chan)){
			return NULL;
		}
		return chan;
	}
	return NULL;
}

//for some reason, sendinput only takes "normalized absolute coordinates", which are never again used in the API
static void wininput_mouse_normalize(long* x, long* y){
	long normalized_x = (double) (*x - cfg.virtual_x) * (65535.0f / (double) cfg.virtual_width);
	long normalized_y = (double) (*y - cfg.virtual_y) * (65535.0f / (double) cfg.virtual_height);

	*x = normalized_x;
	*y = normalized_y;
}

static INPUT wininput_event_mouse(uint8_t channel, uint8_t control, double value){
	DWORD flags_down = 0, flags_up = 0;
	INPUT ev = {
		.type = INPUT_MOUSE
	};

	if(channel == position){
		if(control){
			cfg.mouse_y = value * 0xFFFF;
		}
		else{
			cfg.mouse_x = value * 0xFFFF;
		}

		ev.mi.dwFlags |= MOUSEEVENTF_ABSOLUTE | MOUSEEVENTF_MOVE | MOUSEEVENTF_VIRTUALDESK;
		ev.mi.dx = cfg.mouse_x;
		ev.mi.dy = cfg.mouse_y;
	}
	else if(channel == button){
		switch(control){
			case VK_LBUTTON:
				flags_up |= MOUSEEVENTF_LEFTUP;
				flags_down |= MOUSEEVENTF_LEFTDOWN;
				break;
			case VK_RBUTTON:
				flags_up |= MOUSEEVENTF_RIGHTUP;
				flags_down |= MOUSEEVENTF_RIGHTDOWN;
				break;
			case VK_MBUTTON:
				flags_up |= MOUSEEVENTF_MIDDLEUP;
				flags_down |= MOUSEEVENTF_MIDDLEDOWN;
				break;
			case VK_XBUTTON1:
			case VK_XBUTTON2:
				ev.mi.mouseData = (control == VK_XBUTTON1) ? XBUTTON1 : XBUTTON2;
				flags_up |= MOUSEEVENTF_XUP;
				flags_down |= MOUSEEVENTF_XDOWN;
				break;
		}

		if(value > 0.9){
			ev.mi.dwFlags |= flags_down;
		}
		else{
			ev.mi.dwFlags |= flags_up;
		}
	}
	else if(channel == wheel){
		ev.mi.dwFlags |= MOUSEEVENTF_WHEEL;
		ev.mi.mouseData = ((value * cfg.wheel_max) - cfg.wheel) * cfg.wheel_delta;
		if(cfg.wheel_inverted){
			ev.mi.mouseData *= -1;
		}
		DBGPF("Moving wheel %d (invert %d) with delta %d: %d", (value * cfg.wheel_max) - cfg.wheel, cfg.wheel_inverted, cfg.wheel_delta, ev.mi.mouseData);
		cfg.wheel = (value * cfg.wheel_max);
	}

	return ev;
}

static INPUT wininput_event_keyboard(uint8_t channel, uint8_t control, double value){
	INPUT ev = {
		.type = INPUT_KEYBOARD
	};

	if(channel == keypress){
		ev.ki.wVk = control;
		if(value < 0.9){
			ev.ki.dwFlags |= KEYEVENTF_KEYUP;
		}
	}

	return ev;
}

static int wininput_set(instance* inst, size_t num, channel** c, channel_value* v){
	wininput_channel_ident ident = {
		.label = 0
	};
	size_t n = 0, offset = 0;
	INPUT events[500];

	if(num > sizeof(events) / sizeof(events[0])){
		LOGPF("Truncating output on %s to the last %" PRIsize_t " events, please notify the developers", inst->name, sizeof(events) / sizeof(events[0]));
		offset = num - sizeof(events) / sizeof(events[0]);
	}

	for(n = 0; n + offset < num; n++){
		ident.label = c[n + offset]->ident;
		if(ident.fields.type == mouse){
			events[n] = wininput_event_mouse(ident.fields.channel, ident.fields.control, v[n + offset].normalised);
		}
		else if(ident.fields.type == keyboard){
			events[n] = wininput_event_keyboard(ident.fields.channel, ident.fields.control, v[n + offset].normalised);
		}
		else{
			n--;
			offset++;
		}
	}

	if(n){
		offset = SendInput(n, events, sizeof(INPUT));
		if(offset != n){
			LOGPF("Output %" PRIsize_t " of %" PRIsize_t " events on %s", offset, n, inst->name);
		}
	}
	return 0;
}

static int wininput_handle(size_t num, managed_fd* fds){
	channel_value val = {
		.normalised = 0
	};
	uint8_t mouse_updated = 0, synthesize_off = 0, push_event = 0, current_joystick = 0;
	uint16_t key_state = 0;
	size_t u = 0, n;
	POINT cursor_position;
	JOYINFOEX joy_info;

	for(u = 0; u < cfg.requests; u++){
		synthesize_off = 0;
		push_event = 0;
		val.normalised = 0;

		if(cfg.request[u].ident.fields.type == mouse
				&& cfg.request[u].ident.fields.channel == position){
			if(!mouse_updated){
				//update mouse coordinates
				if(!GetCursorPos(&cursor_position)){
					LOG("Failed to update mouse position");
					continue;
				}
				wininput_mouse_normalize(&cursor_position.x, &cursor_position.y);
				mouse_updated = 1;
				if(cfg.mouse_x != cursor_position.x
						|| cfg.mouse_y != cursor_position.y){
					cfg.mouse_x = cursor_position.x;
					cfg.mouse_y = cursor_position.y;
					mouse_updated = 2;
				}
			}

			val.normalised = (double) cfg.mouse_x / (double) 0xFFFF;
			if(cfg.request[u].ident.fields.control){
				val.normalised = (double) cfg.mouse_y / (double) 0xFFFF;
			}

			if(mouse_updated == 2){
				push_event = 1;
			}
		}
		else if(cfg.request[u].ident.fields.type == mouse
				&& cfg.request[u].ident.fields.channel == wheel){
			//ignore wheel requests, can't read that
		}
		else if(cfg.request[u].ident.fields.type == keyboard
				|| cfg.request[u].ident.fields.type == mouse){
			//check key state
			key_state = GetAsyncKeyState(cfg.request[u].ident.fields.control);
			if(key_state == 1){
				//pressed and released?
				synthesize_off = 1;
			}
			if((key_state & ~1) != cfg.request[u].state){
				//key state changed
				if(key_state){
					val.normalised = 1.0;
				}
				cfg.request[u].state = key_state & ~1;
				push_event = 1;
			}
		}
		else if(cfg.request[u].ident.fields.type == joystick){
			if(cfg.request[u].ident.fields.control >> 8 != current_joystick){
				joy_info.dwSize = sizeof(joy_info);
				joy_info.dwFlags = JOY_RETURNALL | JOY_RETURNPOVCTS;
				if(joyGetPosEx((cfg.request[u].ident.fields.control >> 8) - 1, &joy_info) != JOYERR_NOERROR){
					LOGPF("Failed to query joystick %d", cfg.request[u].ident.fields.control >> 8);
					//early exit because other joystick probably won't be connected either (though this may be wrong)
					//else we would need to think of a way to mark the data invalid for subsequent requests on the same joystick
					return 0;
				}
				current_joystick = cfg.request[u].ident.fields.control >> 8;
			}

			if(cfg.request[u].ident.fields.channel == button){
				//button query
				if(joy_info.dwFlags & JOY_RETURNBUTTONS){
					key_state = (joy_info.dwButtons & (1 << ((cfg.request[u].ident.fields.control & 0xFF) - 1))) > 0 ? 1 : 0;
					if(key_state != cfg.request[u].state){
						if(key_state){
							val.normalised = 1.0;
						}
						cfg.request[u].state = key_state;
						push_event = 1;
						DBGPF("Joystick %d button %d: %d",
								cfg.request[u].ident.fields.control >> 8,
								cfg.request[u].ident.fields.control & 0xFF,
								key_state);
					}
				}
				else{
					LOGPF("No button data received for joystick %d", cfg.request[u].ident.fields.control >> 8);
				}
			}
			else{
				if(!cfg.request[u].max){
					cfg.request[u].max = 0xFFFF;
				}
				val.raw.u64 = cfg.request[u].state;

				//axis requests, every single access to these structures is stupid.
				switch(cfg.request[u].ident.fields.control & 0xFF){
					case 'x':
						if(joy_info.dwFlags & JOY_RETURNX){
							val.raw.u64 = joy_info.dwXpos;
						}
						break;
					case 'y':
						if(joy_info.dwFlags & JOY_RETURNY){
							val.raw.u64 = joy_info.dwYpos;
						}
						break;
					case 'z':
						if(joy_info.dwFlags & JOY_RETURNZ){
							val.raw.u64 = joy_info.dwZpos;
						}
						break;
					case 'r':
						if(joy_info.dwFlags & JOY_RETURNR){
							val.raw.u64 = joy_info.dwRpos;
						}
						break;
					case 'u':
						if(joy_info.dwFlags & JOY_RETURNU){
							val.raw.u64 = joy_info.dwUpos;
						}
						break;
					case 'v':
						if(joy_info.dwFlags & JOY_RETURNV){
							val.raw.u64 = joy_info.dwVpos;
						}
						break;
					case 'p':
						if(joy_info.dwFlags & (JOY_RETURNPOV | JOY_RETURNPOVCTS)){
							val.raw.u64 = joy_info.dwPOV;
						}
						break;
				}

				if(val.raw.u64 != cfg.request[u].state){
					val.normalised = (double) (val.raw.u64 - cfg.request[u].min) / (double) (cfg.request[u].max - cfg.request[u].min);
					cfg.request[u].state = val.raw.u64;
					push_event = 1;
				}
			}
		}

		if(push_event){
			//clamp value just to be safe
			val.normalised = clamp(val.normalised, 1.0, 0.0);
			//push current value to all channels
			DBGPF("Pushing event %f on request %" PRIsize_t, val.normalised, u);
			for(n = 0; n < cfg.request[u].channels; n++){
				mm_channel_event(cfg.request[u].channel[n], val);
			}

			if(synthesize_off){
				val.normalised = 0;
				//push synthesized value to all channels
				DBGPF("Synthesizing event %f on request %" PRIsize_t, val.normalised, u);
				for(n = 0; n < cfg.request[u].channels; n++){
					mm_channel_event(cfg.request[u].channel[n], val);
				}
			}
		}
	}
	return 0;
}

static void wininput_start_joystick(){
	size_t u, p;
	JOYINFOEX joy_info;
	JOYCAPS joy_caps;

	DBGPF("This system supports a maximum of %u joysticks", joyGetNumDevs());
	for(u = 0; u < joyGetNumDevs(); u++){
		joy_info.dwSize = sizeof(joy_info);
		joy_info.dwFlags = 0;
		if(joyGetPosEx(u, &joy_info) == JOYERR_NOERROR){
			if(joyGetDevCaps(u, &joy_caps, sizeof(joy_caps)) == JOYERR_NOERROR){
				LOGPF("Joystick %" PRIsize_t " (%s) is available for input", u + 1, joy_caps.szPname ? joy_caps.szPname : "unknown model");
				for(p = 0; p < cfg.requests; p++){
					if(cfg.request[p].ident.fields.type == joystick
							&& cfg.request[p].ident.fields.channel == position
							&& (cfg.request[p].ident.fields.control >> 8) == u){
						//this looks really dumb, but the structure is defined in a way that prevents us from doing anything clever here
						switch(cfg.request[p].ident.fields.control & 0xFF){
							case 'x':
								cfg.request[p].min = joy_caps.wXmin;
								cfg.request[p].max = joy_caps.wXmax;
								break;
							case 'y':
								cfg.request[p].min = joy_caps.wYmin;
								cfg.request[p].max = joy_caps.wYmax;
								break;
							case 'z':
								cfg.request[p].min = joy_caps.wZmin;
								cfg.request[p].max = joy_caps.wZmax;
								break;
							case 'r':
								cfg.request[p].min = joy_caps.wRmin;
								cfg.request[p].max = joy_caps.wRmax;
								break;
							case 'u':
								cfg.request[p].min = joy_caps.wUmin;
								cfg.request[p].max = joy_caps.wUmax;
								break;
							case 'v':
								cfg.request[p].min = joy_caps.wVmin;
								cfg.request[p].max = joy_caps.wVmax;
								break;
						}
						DBGPF("Updated limits on request %" PRIsize_t " (%c) to %" PRIu32 " / %" PRIu32, p, cfg.request[p].ident.fields.control & 0xFF, cfg.request[p].min, cfg.request[p].max);
					}
				}
			}
			else{
				LOGPF("Joystick %" PRIsize_t " available for input, but no capabilities reported", u + 1);
			}
		}
	}
}

static int wininput_start(size_t n, instance** inst){
	POINT cursor_position;

	//if no input requested, don't request polling
	if(!cfg.requests){
		cfg.interval = 0;
	}

	wininput_start_joystick();

	//read virtual desktop extents for later normalization
	cfg.virtual_width = GetSystemMetrics(SM_CXVIRTUALSCREEN);
	cfg.virtual_height = GetSystemMetrics(SM_CYVIRTUALSCREEN);
	cfg.virtual_x = GetSystemMetrics(SM_XVIRTUALSCREEN);
	cfg.virtual_y = GetSystemMetrics(SM_YVIRTUALSCREEN);
	DBGPF("Virtual screen is %dx%d with offset %dx%d", cfg.virtual_width, cfg.virtual_height, cfg.virtual_x, cfg.virtual_y);

	//sort requests to allow querying each joystick only once
	qsort(cfg.request, cfg.requests, sizeof(wininput_request), request_comparator);

	//initialize mouse position
	if(!GetCursorPos(&cursor_position)){
		LOG("Failed to read initial mouse position");
		return 1;
	}

	DBGPF("Current mouse coordinates: %dx%d (%04Xx%04X)", cursor_position.x, cursor_position.y, cursor_position.x, cursor_position.y);
	wininput_mouse_normalize(&cursor_position.x, &cursor_position.y);
	DBGPF("Current normalized mouse position: %04Xx%04X", cursor_position.x, cursor_position.y);
	cfg.mouse_x = cursor_position.x;
	cfg.mouse_y = cursor_position.y;

	DBGPF("Tracking %" PRIsize_t " input requests", cfg.requests);
	return 0;
}

static int wininput_shutdown(size_t n, instance** inst){
	size_t u;

	for(u = 0; u < cfg.requests; u++){
		free(cfg.request[u].channel);
	}
	free(cfg.request);
	cfg.request = NULL;
	cfg.requests = 0;

	LOG("Backend shut down");
	return 0;
}