Supporto degli utilizzi nei driver digitalizzatore multitocco (Windows 7)

Nel contesto di Windows Touch, il multitocco si riferisce al supporto di due o più punti di contatto rilevabili. In questo argomento vengono descritti gli utilizzi obbligatori e facoltativi per un driver di digitalizzatore multitocco. Se il dispositivo digitalizzatore supporta solo un singolo punto di contatto, vedi Utilizzo di supporto nei driver del digitalizzatore tocco.

I valori dell'identificatore di utilizzo sono definiti nella definizione della classe dispositivo per HID 1.11.

Utilizzi HID obbligatori e facoltativi

Il descrittore di report per un digitalizzatore multitocco deve specificare che il dispositivo è un touch screen HID (pagina 0x0D, utilizzo 0x04).

Oltre agli utilizzi esistenti del tocco HID, i driver del digitalizzatore multitocco devono implementare gli utilizzi seguenti:

• X (0x01 di pagina, 0x30 di utilizzo) e Y (0x01 di pagina, 0x31 di utilizzo)

• Identificatore contatto (0x0D di pagina, 0x51 di utilizzo)

• Opzione suggerimento (0x0D di pagina, 0x42 di utilizzo)

• In-range (0x0D di pagina, 0x32 di utilizzo)

• Numero massimo di contatti (0x0D di pagina, 0x55 di utilizzo)

Gli utilizzi seguenti sono facoltativi, ma i driver del digitalizzatore multitocco devono implementarli se l'hardware del digitalizzatore li supporta. Questi utilizzi sono stati ratificati nell'intervallo di tempo di Windows Vista:

• Attendibilità (0x0D di pagina, 0x47 di utilizzo)

• Larghezza e altezza (0x0D di pagina, 0x48 e 0x49)

• Pressione (0x0D pagina, 0x30 di utilizzo)

Aggiunte HID per supportare il multitocco

Le tabelle di utilizzo HID definiscono gli utilizzi seguenti per l'input multitocco dei digitalizzatori. Windows 7 supporta questi utilizzi multitocco e i fornitori devono implementarli in dispositivi e driver.

• Identificatore contatto

  Specifica l'identificatore del contatto corrente. Un identificatore deve rimanere costante mentre il contatto viene rilevato dal dispositivo. Ogni contatto simultaneo separato deve avere un identificatore univoco. Gli identificatori possono essere riutilizzati se non viene più rilevato un contatto. Se il dispositivo supporta pacchetti "in aria" (il contatto sta passando sopra la superficie), l'identificatore deve essere persistente dal momento in cui il contatto viene rilevato fino al momento in cui non supera l'intervallo. Nel descrittore del report nell'esempio EloMT il commento per questo utilizzo è "Identificatore temp".

• Impostazione

  Applicazione raccolta per la raccolta di livello superiore che contiene il report delle funzionalità.

• Modalità dispositivo

  Funzionalità valore di lettura/scrittura per ottenere e impostare la configurazione di input corrente di un dispositivo. Nell'esempio EloMT il commento per questo utilizzo è "Modalità di input".

• Impostazioni del dispositivo

  Raccolta logica che contiene gli utilizzi della configurazione del dispositivo (Identificatore dispositivo e modalità dispositivo).

• Identificatore dispositivo

  Raccolta di primo livello per la quale è prevista la configurazione. Usare l'identificatore del dispositivo se il descrittore del report contiene più raccolte di input di primo livello. Per altre informazioni specifiche per questo scenario, vedere Uso dei descrittori di report per supportare l'individuazione delle funzionalità.

• Conteggio contatti

  Specifica il numero di contatti validi nel pacchetto corrente. I driver che usano la modalità parallela o ibrida devono includere questo utilizzo. Un dispositivo che non può fornire questo valore deve usare NULL per tutti i valori nella prima posizione che non contengono informazioni di contatto valide.

• Numero massimo contatti

  Specifica il numero totale di contatti supportati da un dispositivo multitocco. Questo utilizzo deve essere incluso nella raccolta di primo livello multitocco e non in alcuna raccolta figlio.

  Il driver fornito dal fornitore può essere sottoposto a query in modo dinamico per questo valore.

È possibile visualizzare esempi degli utilizzi precedenti nell'esempio EloMT in WDK.