The RegisterRawInputDevices function registers the devices that supply the raw input data.

Syntax

BOOL RegisterRawInputDevices(           PCRAWINPUTDEVICE pRawInputDevices,     UINT uiNumDevices,     UINT cbSize );

Parameters

pRawInputDevices

[in] Pointer to an array of RAWINPUTDEVICE structures that represent the devices that supply the raw input.

uiNumDevices

[in] Number of RAWINPUTDEVICE structures pointed to by pRawInputDevices.

cbSize

[in] Size, in bytes, of a RAWINPUTDEVICE structure.

Return Value

TRUE if the function succeeds; otherwise, FALSE. If the function fails, call GetLastError for more information.

Remarks

To receive WM_INPUT messages, an application must first register the raw input devices using RegisterRawInputDevices. By default, an application does not receive raw input.

If a RAWINPUTDEVICE structure has the RIDEV_REMOVE flag set and the hwndTarget parameter is not set to NULL, then parameter validation will fail.

Function Information

Minimum DLL Version	user32.dll
Header	Declared in Winuser.h, include Windows.h
Import library	User32.lib
Minimum operating systems	Windows XP

See Also

Raw Input, RAWINPUTDEVICE, WM_INPUT