Share via


PointerDeviceUsage Struct

Definition

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

A Human Interface Device (HID) usage describes what a Human Interface Device (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.

public value class PointerDeviceUsage
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct PointerDeviceUsage
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct PointerDeviceUsage
var pointerDeviceUsage = {
usagePage : /* Your value */,
usage : /* Your value */,
minLogical : /* Your value */,
maxLogical : /* Your value */,
minPhysical : /* Your value */,
maxPhysical : /* Your value */,
unit : /* Your value */,
physicalMultiplier : /* Your value */
}
Public Structure PointerDeviceUsage
Inheritance
PointerDeviceUsage
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

A Human Interface Device (HID) usage describes what a Human Interface Device (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 1.11.

Note

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

The Universal Serial Bus (USB) Human Interface Device (HID) standard defines the configuration and communication protocols for Human Interface Device (HID), 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 Universal Serial Bus (USB) Human Interface Device (HID) standard, the architecture is not limited to Universal Serial Bus (USB) devices. The input architecture also supports serial port devices, i8042 port devices, and proprietary input devices.

Fields

MaxLogical

The maximum logical value for Usage.

MaxPhysical

The maximum physical value for Usage.

MinLogical

The minimum logical value for Usage.

MinPhysical

The minimum physical value for Usage.

PhysicalMultiplier

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

The Human Interface Device (HID) unit of measure.

Usage

The Human Interface Device (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

The Human Interface Device (HID) usage page of the pointer device. Human Interface Device (HID) usages are organized into usage pages that specify classes of related devices. For example, touch digitizers (0x0D) and generic input (0x01).

Applies to