Coleção de configurações (touchpad-configuration-collection)
Este tópico discute a função executada pela coleção de configuração de um dispositivo de Touchpad de Precisão do Windows, no Windows 10.
Um Touchpad de Precisão do Windows deve fornecer uma coleção de nível superior que faz com que o dispositivo apareça como um digitalizador com opções de configuração (0x0D de página, 0x0E de uso).
A coleção de configuração de um dispositivo Touchpad de Precisão do Windows permite que o host configure dois aspectos diferentes dos dispositivos e, portanto, a coleção deve dar suporte a dois relatórios de recursos: um que permita que o host selecione um modo de entrada e o outro para permitir que o host seja seletivo no que é relatado. Não há relatórios de entrada obrigatórios associados a essa coleção.
Relatório de recursos do modo de entrada
O relatório de recursos do modo de entrada é comunicado pelo host ao dispositivo Touchpad de Precisão do Windows para indicar qual coleção de nível superior deve ser usada para relatórios de entrada. Há duas coleções que podem ser usadas para relatórios de entrada: a coleção mouse e a coleção Touchpad de Precisão do Windows.
Por padrão, os dispositivos Touchpad de Precisão do Windows podem optar por relatar a entrada por meio da coleção de mouses. Um Touchpad de Precisão do Windows só deve relatar dados por meio de uma determinada coleção a qualquer momento. O dispositivo só deve relatar de uma coleção diferente, depois que o relatório de recursos correspondente tiver sido recebido do host indicando o modo de entrada desejado.
O valor especificado pelo host para o modo de entrada (0x52 de uso) determina a coleção que deve ser usada para relatar a entrada. A tabela a seguir fornece mais informações.
| Valor de modo de entrada | Coleção de relatórios de entrada |
|---|---|
| 0 | Coleção mouse |
| 3 | Coleção do Touchpad de Precisão do Windows |
O host pode emitir o modo de entrada do recurso de relatório para um dispositivo Touchpad de Precisão do Windows a qualquer momento depois de ler o descritor do relatório. Isso inclui o tempo durante o qual os dados estão potencialmente sendo relatados por meio da coleção ativa no momento. Caso ocorra uma alternância de modo enquanto os dados estão sendo relatados, todos os contatos e os estados do botão devem ser relatados como ativos e todos os relatórios devem cessar por meio dessa coleção. Os relatórios usando a coleção recém-especificada podem ocorrer depois que todos os contatos estiverem fisicamente em atividade.
Os relatórios por meio da coleção recém-especificada podem ocorrer depois que todos os contatos estiverem fisicamente ativos. O modo de entrada não deve ser mantido por um touchpad de precisão do Windows em ciclos de energia ou em restaurações iniciadas pelo host (restauração de USB, HID I²C HIR, HID SPI HIR). No entanto, o modo de entrada pode ser mantido em qualquer restauração iniciada pelo dispositivo (por exemplo, HID I²C DIR, HID SPI DIR etc.).
Observação É possível que um host não compatível com o touchpad envie um valor diferente daqueles listados na tabela anterior. Nesse caso, o dispositivo deve interpretar o valor como 0 (zero) e alternar para o modo de mouse, pois apenas um sistema operacional compatível com touchpad emitirá o modo 3.
Relatório de recursos de relatório seletivo
O relatório de recursos do modo de entrada é comunicado pelo host ao dispositivo Touchpad de Precisão do Windows para indicar quais tipos de entrada devem ser relatados. Há dois tipos de entrada que podem ser relatados: contatos de superfície e estado do botão.
Por padrão, ou seja, após a inicialização a frio ou após uma redefinição de energia, os dispositivos Touchpad de Precisão do Windows devem relatar contatos de superfície e estado do botão. Um dispositivo Touchpad de Precisão do Windows só deve relatar a entrada que foi selecionada anteriormente pelo host de acordo com o relatório de recursos correspondente.
Os valores especificados pelo host para o alternância de superfície (0x57 de uso) e a opção de botão (0x58 de uso) determinam os tipos de entrada que devem ser relatados. A tabela a seguir fornece mais informações.
| Opção de superfície | Opção de botão | Entrada a ser relatada |
|---|---|---|
| 0 | 0 | Nenhuma entrada deve ser relatada. |
| 0 | 1 | Somente o estado do botão deve ser relatado. |
| 1 | 0 | Somente os contatos de superfície devem ser relatados. |
| 1 | 1 | Os contatos de superfície e o estado do botão devem ser relatados. |
O host pode emitir o relatório seletivo do recurso de relatório para um dispositivo Touchpad de Precisão do Windows a qualquer momento depois de ler o descritor do relatório. O estado de relatório seletivo não deve ser persistido por um Touchpad de precisão do Windows em ciclos de energia.
Quando um dispositivo Touchpad de Precisão do Windows conectado a USB é suspenso, ele só deve sinalizar uma ativação remota com base na entrada que o host selecionou por meio deste relatório de recursos.
Um dispositivo Touchpad de Precisão do Windows conectado ao I²C só deve gerar interrupções baseadas na entrada que o host selecionou por meio desse relatório de recursos.