Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questa sezione descrive come i fornitori usano il descrittore del report per supportare l'individuazione delle funzionalità per dispositivi touch e multitocco.
Descrittore di report
Un driver fornito dal fornitore segnala le funzionalità del dispositivo al sistema operativo fornendo un descrittore di report. Per un esempio completo di descrittore di report, vedere il file Elotouch.c, che fa parte dell'esempio EloMT in Windows Driver Kit (WDK).
Per consentire a Windows 7 di rilevare la capacità di un dispositivo di supportare più input, il driver deve includere l'utilizzo dell'identificatore di contatto (0x51) nel descrittore del report. Tenere presente che nel descrittore di report di esempio (modalità di creazione di report seriali) questo utilizzo si trova nella raccolta fisica di primo livello singolo, mentre in Descrittore report di esempio (modalità parallela/ibrida) questo utilizzo viene visualizzato una volta in entrambe le raccolte logiche che descrivono più input.
Esclusività report funzionalità
In Windows 7, il sistema apre esclusivamente la raccolta di livello superiore della configurazione che contiene il report sulle funzionalità della modalità dispositivo. Poiché il sistema operativo apre esclusivamente il report delle funzionalità, il report non è accessibile alle applicazioni di terze parti.
Poiché Windows 7 configura il dispositivo per segnalare i dati solo da più input, la raccolta di livello superiore deve supportare gli utilizzi multitocco necessari. Per informazioni sugli utilizzi necessari, vedere Supporto degli utilizzi nei driver del digitalizzatore multitocco.
In Windows XP e Windows Vista, le applicazioni di terze parti possono usare il report delle funzionalità per selezionare la modalità di input attualmente attiva, ad esempio l'input basato su tocco singolo o mouse. Ti consigliamo un tocco singolo per Windows XP Tablet PC Edition e Windows Vista. È consigliabile usare il mouse per Windows XP e Microsoft Windows 2000.
Requisiti dei report delle funzionalità
Il report delle funzionalità deve trovarsi nella raccolta principale e deve includere più utilizzi della configurazione di input.
L'esempio seguente mostra un report sulle funzionalità di Elotouch.c:
0x09, 0x0E, // USAGE (Device Configuration)
0xa1, 0x01, // COLLECTION (Application)
0x85, REPORTID_FEATURE, // REPORT_ID (Configuration)
0x09, 0x23, // USAGE (Device Settings)
0xa1, 0x02, // COLLECTION (logical)
0x09, 0x52, // USAGE (Device Mode)
0x09, 0x53, // USAGE (Device Identifier)
0x15, 0x00, // LOGICAL_MINIMUM (0)
0x25, 0x0a, // LOGICAL_MAXIMUM (10)
0x75, 0x08, // REPORT_SIZE (8)
0x95, 0x02, // REPORT_COUNT (2)
0xb1, 0x02, // FEATURE (Data,Var,Abs
0xc0, // END_COLLECTION
0xc0, // END_COLLECTION
Modalità dispositivo
L'utilizzo della modalità dispositivo (0x52) può avere uno dei valori seguenti:
| Mode | Valore |
|---|---|
Mouse (impostazione predefinita consigliata) |
0x00 |
Input singolo (tocco singolo o stilo) |
0x01 |
Più input |
0x02 |
Quando è impostata la modalità di input singolo, i fornitori possono eseguire una delle operazioni seguenti:
Inviare informazioni solo sul primo contatto. Questa operazione può essere implementata nel firmware o nel driver di dispositivo.
Eliminare tutte le informazioni sugli altri contatti nel minidriver HID. Questo approccio riduce la logica necessaria nel firmware. Tuttavia, è disponibile solo per gli implementatori che scelgono di scrivere un driver di dispositivo.
Quando è impostata la modalità mouse, il firmware o il driver di dispositivo deve instradare i dati dal primo contatto rilevato usando la raccolta di livello superiore del mouse.
Scegliere la modalità dispositivo predefinita appropriata per il dispositivo in base alle funzionalità del dispositivo e alle versioni del sistema operativo supportate. Per garantire la compatibilità con le versioni precedenti di Windows, è consigliabile usare la modalità mouse come predefinita. Con l'impostazione predefinita impostata sulla modalità mouse, il dispositivo può funzionare con qualsiasi sistema operativo.
Se puoi garantire che il dispositivo non verrà usato in alcuna versione di Windows precedente a Windows Vista, è preferibile impostare l'impostazione predefinita sulla modalità a input singolo. Windows 7 riconfigura il dispositivo per più input se individua la funzionalità.
Identificatore dispositivo
Identificatore dispositivo (0x53) è un valore statico (SV) quando fa parte di una raccolta di livello superiore del mouse o digitalizzatore. È necessario quando un descrittore di report contiene più raccolte di livello superiore del digitalizzatore dello stesso tipo. Questo utilizzo identifica in modo univoco la raccolta di livello superiore del digitalizzatore e dovrebbe essere visualizzato nel report delle funzionalità.
Se il dispositivo può funzionare come mouse, la raccolta del mouse deve avere lo stesso identificatore del dispositivo della raccolta di digitalizzatore corrispondente. I dispositivi con una sola raccolta di livello superiore del digitalizzatore non sono necessari per specificare l'utilizzo di un identificatore di dispositivo.
Quando l'utilizzo fa parte di una raccolta logica delle impostazioni del dispositivo, si tratta di un valore dinamico (DV). In questo scenario, l'utilizzo consente all'host di selezionare il dispositivo che vuole configurare. Il valore zero indica tutte le raccolte. Un valore diverso da zero indica la raccolta di livello superiore con l'identificatore del dispositivo corrispondente.
Supporto tocco e penna
Se il dispositivo include un digitalizzatore che fornisce funzionalità sia di Windows Touch che di penna, è necessario segnalare separatamente le raccolte di tocco e penna. Se il driver potrebbe essere installato in un tablet tablet o in un altro computer senza mouse, è necessario segnalare anche una raccolta di mouse.