Share via

estrutura USAGE_PROPERTIES (winuser.h)

  • Artigo

Contém propriedades do dispositivo (HID (Dispositivo de Interface Humana) itens globais que correspondem aos usos de HID) para qualquer tipo de dispositivo de entrada HID.

Sintaxe

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;

Membros

level

Um valor específico de uso para um controle linear baseado em intervalo (botão de botão ou discagem), um controle ativado/desativado (botão de alternância), um controle momentâneo (botão do mouse), um controle de uma captura (botão que dispara um único evento) ou um controle de re-gatilho (botão que dispara um evento repetido).

page

A ID da página de uso, como página controles VR (0x03) ou página Controles de Jogo (0x05).

usage

A ID de Uso associada a uma Página de Uso, como Virar para a Direita/Esquerda (21) ou Mover para a Direita/Esquerda (24) para uma Página de Controles de Jogo.

logicalMinimum

O menor valor que o controle pode relatar.

logicalMaximum

O maior valor que o controle pode relatar.

unit

O padrão de medida usado para descrever o valor físico de um controle (depois de converter o valor lógico usando o valor expoente ). A especificação HID define códigos para as unidades básicas de comprimento, massa, tempo, temperatura, intensidade atual e luminosa.

exponent

O valor usado para dimensionar um valor lógico para um valor físico.

count

O número de itens de dados contidos no relatório.

physicalMinimum

O logicalMinimum expresso em unidades físicas (convertido multiplicando logicalMinimum por expoente).

physicalMaximum

O logicalMaximum expresso em unidades físicas (convertido multiplicando logicalMaximum por expoente).

Comentários

O grupo de trabalho HID publica um conjunto de documentos que compõem as Tabelas de Uso hid (o dicionário que descreve o que os dispositivos HID têm permissão para fazer). Essas tabelas de uso hid contêm uma lista com descrições de uso. Um Uso fornece informações a um desenvolvedor de aplicativos sobre o significado pretendido e o uso de um item específico descrito no Descritor de Relatório. Por exemplo, há um Uso definido para o botão esquerdo de um mouse. O Descritor de Relatório pode definir onde em um relatório um aplicativo pode encontrar o estado atual do botão esquerdo do mouse. As Tabelas de Uso são divididas em vários espaços de nome, chamados Páginas de Uso. Cada Página de Uso descreve um conjunto de Usos relacionados para ajudar a organizar o documento. A combinação de uma Página de Uso e Uso define a ID de Uso que identifica exclusivamente um uso específico nas tabelas de uso.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server [somente aplicativos da área de trabalho]
Cabeçalho winuser.h

Confira também

Tabelas de uso hid do barramento serial universal – USB.org