Relatórios de entrada do controlador radial do Windows
Este tópico detalha o relatório de entrada HID usado para dar suporte a comentários táteis do controlador radial no Windows 10, versão 1607 e sistemas operacionais posteriores.
O host faz uso dos seguintes usos ao extrair dados de um relatório de entrada:
| Membro | Descrição | ? | ID | Obrigatório/opcional |
|---|---|---|---|---|
| Botão | Estado do botão localizado no controlador radial | 0x09 | 0x01 | Obrigatório |
| Discagem | Rotação relativa do controlador radial | 0x01 | 0x37 | Obrigatório |
| X | Coordenada X de posição do contato | 0x01 | 0x30 | Opcional |
| Y | Coordenada Y de posição do contato | 0x01 | 0x31 | Opcional |
| Largura | Largura da caixa delimitadora em torno de um contato | 0x0D | 0x48 | Opcional |
| Altura | Altura da caixa delimitadora em torno de um contato | 0x0D | 0x49 | Opcional |
Usos opcionais obrigatórios e compatíveis com Windows
Qualquer dispositivo que não relatar todos os usos obrigatórios não funcionará como um controlador radial do Windows. Os usos obrigatórios são estritamente impostos pelo host do Windows. Quando um valor máximo lógico não for restringido, ele poderá ser otimizado para reduzir o tamanho do descritor.
As seções a seguir fornecem mais detalhes sobre os usos opcionais obrigatórios e compatíveis com o Windows que foram apresentados na tabela acima.
Botão
Usado para indicar quando o botão primário no dispositivo do controlador radial é pressionado. Isso é indicado por um item principal com um tamanho de relatório de 1 bit. Ao entregar um relatório de entrada, o bit deve ser definido quando esse botão é pressionado e apagado quando o botão é liberado.
Discagem
Usado para indicar a rotação no sentido horário do controlador radial em torno de seu próprio eixo principal. Ao fornecer um relatório de entrada, o valor relatado deve ser a magnitude da rotação em relação ao relatório anterior. Esse valor será positivo se o controlador radial for girado em sentido horário e negativo se o controlador radial for girado em sentido anti-horário.
O alcance físico e o alcance lógico precisam ser especificados. Graus ou radianos podem ser usados para o intervalo físico. Em ambos os casos, o intervalo lógico deve ser grande o suficiente para relatar valores precisos para, pelo menos, um local decimal.
X/Y
X e Y relatam as coordenadas do contato de um controlador radial na tela. Essa coordenada representa o centro do contato em relação à exibição.
Os dispositivos que relatam X e Y também devem relatar um uso de largura ou altura. O host usa a coordenada relatada para criar o retângulo delimitador ao redor do contato.
Os seguintes itens globais precisam ser especificados para os usos de X e Y:
- Mínimo lógico
- Máximo lógico
- Mínimo físico
- Máximo físico
- Unidade
- Expoente de unidade
O alcance físico do dispositivo e das unidades precisa ser relatado com precisão. Se as informações forem imprecisas, o dispositivo não funcionará corretamente. Os dispositivos também precisam relatar dados dentro do alcance lógico especificado no descritor de relatório.
X e Y podem fornecer um valor NULL ao sistema, implicando que o dispositivo não tem atualmente uma posição relativa a uma exibição, fornecendo um valor fora do intervalo lógico relatado e adicionando Suporte Nulo ao relatório de entrada do uso (Bit 6 {Sem posição nula (0) | Estado nulo(1)}).
Largura e altura
Os usos de largura e altura representam a largura e a altura da caixa delimitadora ao redor do contato do controlador radial. A largura e a altura devem ser definidas como constantes no descritor do relatório.
Um dispositivo do controlador radial do Windows é considerado circular pelo sistema. Por isso, não é necessário relatar largura e altura para um contato na tela. Se houver suporte para altura ou largura, os limites do contato serão interpretados pelo sistema corretamente. O Windows não oferece suporte para dispositivos de controlador radial com valores diferentes para largura e altura.