Share via

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

0x03(VR 컨트롤 페이지) 또는 게임 컨트롤 페이지(0x05)와 같은 사용 페이지 ID입니다.

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