USAGE_PROPERTIES struttura (winuser.h)

Articolo
03/04/2024

Contiene le proprietà del dispositivo (Human Interface Device (HID) globali che corrispondono agli usi HID) per qualsiasi tipo di dispositivo di input HID.

Sintassi

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;

Members

level

Valore specifico dell'utilizzo per un controllo lineare basato su intervallo (knob o dial), un controllo attivo/disattivato (interruttore attiva), un controllo momentaneo (pulsante del mouse), un controllo a uno colpo (pulsante che attiva un singolo evento) o un controllo re-trigger (pulsante che attiva un evento ripetuto).

page

ID pagina utilizzo, ad esempio pagina controlli VR (0x03) o pagina Controlli gioco (0x05).

usage

ID utilizzo associato a una pagina di utilizzo, ad esempio Turn Right/Left (21) o Move Right/Left (24) per una pagina dei controlli di gioco.

logicalMinimum

Valore più piccolo che il controllo può segnalare.

logicalMaximum

Valore più grande che il controllo può segnalare.

unit

Lo standard di misura usato per descrivere il valore fisico di un controllo (dopo aver convertito il valore logico usando il valore esponente ). La specifica HID definisce i codici per le unità di base di lunghezza, massa, tempo, temperatura, corrente e intensità luminosa.

exponent

Valore utilizzato per ridimensionare un valore logico in un valore fisico.

count

Numero di elementi di dati contenuti nel report.

physicalMinimum

Il logicMinimum espresso in unità fisiche (convertito moltiplicando logicMinimumdall'esponente).

physicalMaximum

LogicoMaximum espresso in unità fisiche (convertito moltiplicando logicMaximum da esponente).

Commenti

Il gruppo di lavoro HID pubblica un set di documenti che costituiscono le tabelle di utilizzo HID (dizionario che descrive i dispositivi HID consentiti). Queste tabelle di utilizzo HID contengono un elenco con descrizioni di utilizzo. Un utilizzo fornisce informazioni a uno sviluppatore di applicazioni sul significato previsto e sull'uso di un particolare elemento descritto nel descrittore di report. Ad esempio, esiste un utilizzo definito per il pulsante sinistro di un mouse. Il descrittore di report può definire dove in un report un'applicazione può trovare lo stato corrente del pulsante sinistro del mouse. Le tabelle di utilizzo vengono suddivise in diversi spazi dei nomi, denominate Pagine di utilizzo. Ogni pagina utilizzo descrive un set di utilizzo correlati per organizzare il documento. La combinazione di una pagina di utilizzo e utilizzo definisce l'ID utilizzo che identifica in modo univoco un utilizzo specifico nelle tabelle di utilizzo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809 [solo app desktop]
Server minimo supportato	Windows Server [solo app desktop]
Intestazione	Winuser

Vedi anche

Tabelle di utilizzo HID del bus seriale universale - USB.org

Condividi tramite