USAGE_PROPERTIES
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| level | WORD | 2 | +0 | +0 | 範囲ベースのリニア コントロール (ノブまたはダイヤル)、オン/オフ コントロール (トグル スイッチ)、モーメンタリ コントロール (マウス ボタン)、ワンショット コントロール (単一のイベントを発生させるボタン)、または再トリガー コントロール (繰り返しイベントを発生させるボタン) に対する、Usage 固有の値です。 |
| page | WORD | 2 | +2 | +2 | VR Controls Page (0x03) や Game Controls Page (0x05) などの Usage Page ID です。 |
| usage | WORD | 2 | +4 | +4 | Game Controls Page における Turn Right/Left (21) や Move Right/Left (24) など、Usage Page に関連付けられた Usage ID です。 |
| logicalMinimum | INT | 4 | +8 | +8 | コントロールが報告できる最小の値です。 |
| logicalMaximum | INT | 4 | +12 | +12 | コントロールが報告できる最大の値です。 |
| unit | WORD | 2 | +16 | +16 | コントロールの物理値 (exponent の値を使用して論理値から変換した値) を表すために使用される測定の基準です。HID 仕様では、長さ、質量、時間、温度、電流、光度という基本単位のコードが定義されています。 |
| exponent | WORD | 2 | +18 | +18 | 論理値を物理値にスケーリングするために使用される値です。 |
| count | BYTE | 1 | +20 | +20 | レポートに含まれるデータ項目の数です。 |
| physicalMinimum | INT | 4 | +24 | +24 | logicalMinimum を物理単位で表した値です (logicalMinimum に exponent を乗算して変換します)。 |
| physicalMaximum | INT | 4 | +28 | +28 | logicalMaximum を物理単位で表した値です (logicalMaximum に exponent を乗算して変換します)。 |
公式ドキュメント
あらゆる種類の HID 入力デバイスのデバイス プロパティ (HID の Usage に対応する、ヒューマン インターフェイス デバイス (HID) のグローバル アイテム) を格納します。
解説(Remarks)
HID ワーキング グループは、HID Usage Tables (HID デバイスが何を行えるかを記述した辞書) を構成する一連のドキュメントを公開しています。これらの HID Usage Tables には、Usage の説明の一覧が含まれています。Usage は、Report Descriptor に記述された特定の項目について、その意図された意味と用途に関する情報をアプリケーション開発者に提供します。たとえば、マウスの左ボタンに対する Usage が定義されています。Report Descriptor は、マウスの左ボタンの現在の状態をアプリケーションがレポート内のどこで見つけられるかを定義できます。Usage Tables は、Usage Page と呼ばれる複数の名前空間に分割されています。各 Usage Page は、ドキュメントを整理しやすくするために、関連する一連の Usage を記述します。Usage Page と Usage の組み合わせによって、Usage Tables 内の特定の Usage を一意に識別する Usage ID が定義されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// USAGE_PROPERTIES (x64 32 / x86 32 バイト)
typedef struct USAGE_PROPERTIES {
WORD level;
WORD page;
WORD usage;
INT logicalMinimum;
INT logicalMaximum;
WORD unit;
WORD exponent;
BYTE count;
INT physicalMinimum;
INT physicalMaximum;
} USAGE_PROPERTIES;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USAGE_PROPERTIES
{
public ushort level;
public ushort page;
public ushort usage;
public int logicalMinimum;
public int logicalMaximum;
public ushort unit;
public ushort exponent;
public byte count;
public int physicalMinimum;
public int physicalMaximum;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USAGE_PROPERTIES
Public level As UShort
Public page As UShort
Public usage As UShort
Public logicalMinimum As Integer
Public logicalMaximum As Integer
Public unit As UShort
Public exponent As UShort
Public count As Byte
Public physicalMinimum As Integer
Public physicalMaximum As Integer
End Structureimport ctypes
from ctypes import wintypes
class USAGE_PROPERTIES(ctypes.Structure):
_fields_ = [
("level", ctypes.c_ushort),
("page", ctypes.c_ushort),
("usage", ctypes.c_ushort),
("logicalMinimum", ctypes.c_int),
("logicalMaximum", ctypes.c_int),
("unit", ctypes.c_ushort),
("exponent", ctypes.c_ushort),
("count", ctypes.c_ubyte),
("physicalMinimum", ctypes.c_int),
("physicalMaximum", ctypes.c_int),
]#[repr(C)]
pub struct USAGE_PROPERTIES {
pub level: u16,
pub page: u16,
pub usage: u16,
pub logicalMinimum: i32,
pub logicalMaximum: i32,
pub unit: u16,
pub exponent: u16,
pub count: u8,
pub physicalMinimum: i32,
pub physicalMaximum: i32,
}import "golang.org/x/sys/windows"
type USAGE_PROPERTIES struct {
level uint16
page uint16
usage uint16
logicalMinimum int32
logicalMaximum int32
unit uint16
exponent uint16
count byte
physicalMinimum int32
physicalMaximum int32
}type
USAGE_PROPERTIES = record
level: Word;
page: Word;
usage: Word;
logicalMinimum: Integer;
logicalMaximum: Integer;
unit: Word;
exponent: Word;
count: Byte;
physicalMinimum: Integer;
physicalMaximum: Integer;
end;const USAGE_PROPERTIES = extern struct {
level: u16,
page: u16,
usage: u16,
logicalMinimum: i32,
logicalMaximum: i32,
unit: u16,
exponent: u16,
count: u8,
physicalMinimum: i32,
physicalMaximum: i32,
};type
USAGE_PROPERTIES {.bycopy.} = object
level: uint16
page: uint16
usage: uint16
logicalMinimum: int32
logicalMaximum: int32
unit: uint16
exponent: uint16
count: uint8
physicalMinimum: int32
physicalMaximum: int32struct USAGE_PROPERTIES
{
ushort level;
ushort page;
ushort usage;
int logicalMinimum;
int logicalMaximum;
ushort unit;
ushort exponent;
ubyte count;
int physicalMinimum;
int physicalMaximum;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USAGE_PROPERTIES サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; level : WORD (+0, 2byte) wpoke st,0,値 / 値 = wpeek(st,0)
; page : WORD (+2, 2byte) wpoke st,2,値 / 値 = wpeek(st,2)
; usage : WORD (+4, 2byte) wpoke st,4,値 / 値 = wpeek(st,4)
; logicalMinimum : INT (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; logicalMaximum : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; unit : WORD (+16, 2byte) wpoke st,16,値 / 値 = wpeek(st,16)
; exponent : WORD (+18, 2byte) wpoke st,18,値 / 値 = wpeek(st,18)
; count : BYTE (+20, 1byte) poke st,20,値 / 値 = peek(st,20)
; physicalMinimum : INT (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; physicalMaximum : INT (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global USAGE_PROPERTIES
#field short level
#field short page
#field short usage
#field int logicalMinimum
#field int logicalMaximum
#field short unit
#field short exponent
#field byte count
#field int physicalMinimum
#field int physicalMaximum
#endstruct
stdim st, USAGE_PROPERTIES ; NSTRUCT 変数を確保
st->level = 100
mes "level=" + st->level