GetRegisteredRawInputDevices function (winuser.h)

Retrieves the information about the raw input devices for the current application.

Syntax

UINT GetRegisteredRawInputDevices(
  [out, optional] PRAWINPUTDEVICE pRawInputDevices,
  [in, out]       PUINT           puiNumDevices,
  [in]            UINT            cbSize
);

Parameters

[out, optional] pRawInputDevices

Type: PRAWINPUTDEVICE

An array of RAWINPUTDEVICE structures for the application. Pointer should be aligned on a DWORD (32-bit) boundary.

[in, out] puiNumDevices

Type: PUINT

The number of RAWINPUTDEVICE structures in *pRawInputDevices.

[in] cbSize

Type: UINT

The size, in bytes, of a RAWINPUTDEVICE structure.

Return value

Type: UINT

If successful, the function returns a non-negative number that is the number of RAWINPUTDEVICE structures written to the buffer.

If the pRawInputDevices buffer is too small or NULL, the function sets the last error as ERROR_INSUFFICIENT_BUFFER, returns -1, and sets puiNumDevices to the required number of devices. If the function fails for any other reason, it returns -1. For more details, call GetLastError.

Remarks

To receive raw input from a device, an application must register it by using RegisterRawInputDevices.

Requirements

See also

Conceptual

RAWINPUTDEVICE

Raw Input

Reference

RegisterRawInputDevices