GetPointerDevices function

Gets information about the pointer devices attached to the system.

Syntax


WINUSERAPI BOOL WINAPI WINAPI GetPointerDevices(
  _Inout_    UINT32 *deviceCount,
  _Out_opt_  POINTER_DEVICE_INFO *pointerDevices
);

Parameters

deviceCount [in, out]

If pointerDevices is NULL, deviceCount returns the total number of attached pointer devices. Otherwise, deviceCount specifies the number of POINTER_DEVICE_INFO structures pointed to by pointerDevices.

pointerDevices [out, optional]

Array of POINTER_DEVICE_INFO structures for the pointer devices attached to the system. If NULL, the total number of attached pointer devices is returned in deviceCount.

Return value

If this function succeeds, it returns TRUE. Otherwise, it returns FALSE. To retrieve extended error information, call the GetLastError function.

Remarks

Windows 8 supports the following:

  • 256 contacts per pointer device.
  • 2560 total contacts per system session, regardless of the number of attached devices. For example, 10 pointer devices with 256 contacts each, 20 pointer devices with 128 contacts each, and so on.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Winuser.h

Library

User32.lib

DLL

User32.dll

See also

Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft