PointerDeviceUsage structure

Applies to Windows and Windows Phone

Identifies the Human Interface Device (HID) usage details for the input device.

A HID usage describes what a HID-compliant control is measuring or reporting and can also indicate the control's intended use. A specific control usage is defined by its usage page, a usage ID, a name, and a description.

Syntax


Public Structure PointerDeviceUsage

Attributes

[Version(0x06020000)]

Members

The PointerDeviceUsage structure has these fields.

FieldData typeDescription
MaxLogical | maxLogical

Number [JavaScript] | System.Int32 [.NET] | int32 [C++]

The maximum logical value for Usage.

MaxPhysical | maxPhysical

Number [JavaScript] | System.Int32 [.NET] | int32 [C++]

The maximum physical value for Usage.

MinLogical | minLogical

Number [JavaScript] | System.Int32 [.NET] | int32 [C++]

The minimum logical value for Usage.

MinPhysical | minPhysical

Number [JavaScript] | System.Int32 [.NET] | int32 [C++]

The minimum physical value for Usage.

PhysicalMultiplier | physicalMultiplier

Number [JavaScript] | System.Single [.NET] | float32 [C++]

The multiplier used to convert the usage value reported by the device to a physical value in units of Unit. (Valid only for usages that indicate a static or dynamic value associated with a control, such as pressure or width and height of the touch contact.)

Unit | unit

Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The HID unit of measure.

Usage | usage

Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The HID pointer device usage ID that specifies a device or property in the UsagePage. For example, 0x04 indicates a touch screen device and 0x47 indicates touch confidence.

Note  A usage ID of zero is reserved.

UsagePage | usagePage

Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The HID usage page of the pointer device.

HID usages are organized into usage pages that specify classes of related devices. For example, touch digitizers (0x0D) and generic input (0x01).

 

Remarks

A HID usage describes what a HID-compliant control is measuring or reporting and can also indicate the control's intended use. A specific control usage is defined by its usage page, a usage ID, a name, and a description. For more info, see Device Class Definition for HID.

Note  

The core of the Microsoft interactive input device architecture is based on the Universal Serial Bus (USB) standard Device Class Definition for HIDs, which is defined by the USB Implementers Forum, Inc.

The USB HID standard defines the configuration and communication protocols for HIDs, such as keyboards, mouse devices, joysticks, and virtual reality devices, that humans use to enter data directly into a computer. (For detailed information about the USB HID standard, see the USB Implementers Forum website.)

Although the core of the Windows input architecture is based on the USB HID standard, the architecture is not limited to USB devices. The input architecture also supports serial port devices, i8042 port devices, and proprietary input devices.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Devices.Input
Windows::Devices::Input [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft