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

範囲ベースのリニア コントロール (ノブまたはダイヤル)、オン/オフ コントロール (トグル スイッチ)、瞬間コントロール (マウス ボタン)、ワンショット コントロール (1 つのイベントをトリガーするボタン)、または再トリガー コントロール (繰り返しイベントをトリガーするボタン) の使用固有の値。

page

VR コントロール ページ (0x03) やゲーム コントロール ページ (0x05) などの利用状況ページ ID。

usage

ゲーム コントロール ページの [右/左に移動] (21) や [右/左に移動] (24) など、使用状況ページに関連付けられている使用状況 ID。

logicalMinimum

コントロールが報告できる最小値。

logicalMaximum

コントロールが報告できる最大値。

unit

コントロールの物理値を記述するために使用されるメジャーの標準 ( 指数 値を使用して論理値を変換した後)。 HID 仕様では、長さ、質量、時間、温度、電流、および発光強度の基本単位のコードを定義します。

exponent

論理値を物理値にスケーリングするために使用される値。

count

レポートに含まれるデータ 項目の数。

physicalMinimum

物理単位で表される logicalMinimum ( 論理Minimum に 指数を乗算して変換)。

physicalMaximum

物理単位で表される logicalMaximum ( logicalMaximum に 指数を乗算して変換)。

注釈

HID 作業グループは、HID 使用状況テーブルを構成する一連のドキュメント (HID デバイスの実行を許可するディクショナリ) を発行します。 これらの HID 使用状況テーブルには、使用状況の説明を含む一覧が含まれています。 使用状況は、レポート記述子で説明されている特定のアイテムの意図された意味と使用方法に関する情報をアプリケーション開発者に提供します。 たとえば、マウスの左ボタンに対して定義された使用法があります。 レポート記述子では、アプリケーションがマウスの左ボタンの現在の状態を見つけることができるレポート内の場所を定義できます。 使用法テーブルは、使用法ページと呼ばれる複数の名前空間に分割されています。 使用法の各ページには、ドキュメントを整理するのに役立つ、関連する使用法のセットが説明されています。 使用状況ページと使用状況の組み合わせは、使用状況テーブル内の特定の使用状況を一意に識別する使用状況 ID を定義します。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1809 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server [デスクトップ アプリのみ]
Header winuser.h

こちらもご覧ください

ユニバーサル シリアル バス HID 使用法テーブル - USB.org