funzione HidD_GetPhysicalDescriptor (hidsdi.h)
La routine HidD_GetPhysicalDescriptor restituisce il descrittore fisico di una raccolta di primo livello che identifica il dispositivo fisico della raccolta.
Il descrittore fisico viene usato per indicare quale parte fisica del corpo umano viene usata per attivare i controlli in un dispositivo. Ad esempio, un descrittore fisico potrebbe indicare che il pollice destro viene usato per attivare il pulsante 5.
Si noti che i descrittori fisici sono completamente facoltativi. Aggiungono complessità e offrono molto poco in cambio per la maggior parte dei dispositivi. Tuttavia, alcuni dispositivi, in particolare quelli con un numero elevato di controlli identici (ad esempio pulsanti) troveranno che i descrittori fisici consentono a diverse applicazioni di assegnare funzionalità a questi controlli in modo più coerente. Per altre informazioni, vedi Specifica HID .
Sintassi
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Parametri
[in] HidDeviceObject
Specifica un handle aperto per una raccolta di primo livello.
[out] Buffer
Puntatore a un buffer allocato dal chiamante utilizzato dalla routine per restituire il descrittore fisico richiesto.
[in] BufferLength
Specifica la lunghezza, in byte, del buffer in Buffer.
Valore restituito
HidD_GetPhysicalDescriptor restituisce TRUE se ha esito positivo; in caso contrario, restituisce FALSE. Usare GetLastError per ottenere informazioni estese sull'errore.
Commenti
Solo le applicazioni in modalità utente possono chiamare HidD_GetPhysicalDescriptor. I driver in modalità kernel possono usare una richiesta di IOCTL_GET_PHYSICAL_DESCRIPTOR .
Per altre informazioni, vedere Raccolte HID.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | hidsdi.h (include Hidsdi.h) |
| Libreria | Hid.lib |
| DLL | Hid.dll |