Coleções de nível superior

Uma coleção de nível superior é um agrupamento de funcionalidade que tem como alvo um consumidor de software específico (ou tipo de consumidor) da funcionalidade. Por exemplo, uma coleção de nível superior pode ser descrita como teclado, mouse, controle do consumidor, sensor, exibição e assim por diante. Na especificação HID, essas coleções de nível superior também são conhecidas como coleções de aplicativos. O dispositivo HID descreve a finalidade de cada coleção de nível superior, permitindo que os consumidores da funcionalidade HID identifiquem coleções de nível superior nas quais estão interessados. No Windows, a classe de instalação do dispositivo HID (HIDClass) gera um PDO (objeto de dispositivo físico) exclusivo para cada coleção de nível superior descrita pelo descritor de relatório. A Microsoft define uma coleção de nível superior como uma coleção HID que não está aninhada em outra coleção. Uma coleção não aninhada é sempre uma coleção de nível superior, independentemente de seu tipo HID. Em particular, uma coleção de nível superior não precisa ser uma coleção de aplicativos, conforme definido pelo USB HID Standard.

Um descritor de relatório pode incluir mais de uma coleção de nível superior. O driver de classe HID enumera as coleções de nível superior de um dispositivo de entrada e cria um PDO (objeto de dispositivo físico) para cada coleção de nível superior. Aplicativos em modo usuário ou drivers em modo kernel podem acessar uma coleção de nível superior abrindo seu PDO e usando as rotinas de suporte HIDClass e os IOCTLs do driver de classe HID.

A lista a seguir descreve a estrutura interna e a capacidade de uma coleção de nível superior:

• Uma estrutura de HIDP_CAPS resume a funcionalidade de uma coleção de nível superior.
• Coleções de links descrevem a organização das coleções aninhadas dentro de uma coleção de nível superior.
• Matrizes de capacidade de botão e matrizes de capacidade de valor descrevem a capacidade dos controles suportados pela coleção de nível superior.