USAGE_PROPERTIES 结构 (winuser.h)

包含设备属性 (人机接口设备 (HID) 全局项,对应于任何类型的 HID 输入设备的 HID 用法) 。

语法

typedef struct tagUSAGE_PROPERTIES {
  USHORT level;
  USHORT page;
  USHORT usage;
  INT32  logicalMinimum;
  INT32  logicalMaximum;
  USHORT unit;
  USHORT exponent;
  BYTE   count;
  INT32  physicalMinimum;
  INT32  physicalMaximum;
} USAGE_PROPERTIES, *PUSAGE_PROPERTIES;

成员

level

基于范围的线性控件 (旋钮或拨号) 、开/关控件 (切换开关) 、鼠标按钮) (瞬时控件、触发单个事件) 的一次性控件 (按钮,或触发) 重复事件的 (控件按钮。

page

使用情况页 ID,例如 VR 控件页面 (0x03) 或游戏控件页面 (0x05) 。

usage

与使用情况页关联的使用情况 ID,例如向右/向左 (21) 或向右/向左移动 (24) 游戏控件页。

logicalMinimum

控件可以报告的最小值。

logicalMaximum

控件可以报告的最大值。

unit

用于描述控件的物理值的度量标准,在使用 指数 值) 转换逻辑值后 (。 HID 规范定义了长度、质量、时间、温度、电流和发光强度的基本单位的代码。

exponent

用于将逻辑值缩放为物理值的值。

count

报表中包含的数据项数。

physicalMinimum

以物理单位表示的 logicalMinimum (将 logicalMinimum 乘以 指数) 进行转换。

physicalMaximum

以物理单位表示的 logicalMaximum (将 logicalMaximum 乘以 指数) 进行转换。

注解

HID 工作组发布一组构成 HID 使用情况表的文档, (描述允许哪些 HID 设备执行) 的字典。 这些 HID 使用情况表包含一个包含使用情况说明的列表。 使用情况向应用程序开发人员提供有关报表描述符中描述的特定项的预期含义和用法的信息。 例如,为鼠标的左侧按钮定义了“用法”。 报表描述符可以定义应用程序可以在报表中查找鼠标左键的当前状态的位置。 用法表分为多个称为“用法页”的命名空间。 每个用法页描述了一组相关的用法,有助于组织文档。 “使用情况页”和“使用情况”的组合定义了唯一标识使用情况表中特定使用情况的使用情况 ID。

要求

要求
最低受支持的客户端 Windows 10 版本 1809 [仅限桌面应用]
最低受支持的服务器 Windows Server [仅限桌面应用]
标头 winuser.h

另请参阅

通用串行总线 HID 使用情况表 - USB.org