fonction HidD_GetPhysicalDescriptor (hidsdi.h)
La routine HidD_GetPhysicalDescriptor retourne le descripteur physique d’une collection de niveau supérieur qui identifie l’appareil physique de la collection.
Le descripteur physique est utilisé pour indiquer quelle partie physique du corps humain est utilisée pour activer les contrôles sur un appareil. Par exemple, un descripteur physique peut indiquer que le pouce droit est utilisé pour activer le bouton 5.
Notez que les descripteurs physiques sont entièrement facultatifs . Ils ajoutent de la complexité et offrent très peu en retour pour la plupart des appareils. Toutefois, certains appareils, en particulier ceux avec un grand nombre de contrôles identiques (par exemple, des boutons) constatent que les descripteurs physiques aident différentes applications à attribuer des fonctionnalités à ces contrôles de manière plus cohérente. Pour plus d’informations, consultez Spécification HID .
Syntaxe
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Paramètres
[in] HidDeviceObject
Spécifie un handle ouvert à une collection de niveau supérieur.
[out] Buffer
Pointeur vers une mémoire tampon allouée à l’appelant que la routine utilise pour retourner le descripteur physique demandé.
[in] BufferLength
Spécifie la longueur, en octets, de la mémoire tampon dans Mémoire tampon.
Valeur retournée
HidD_GetPhysicalDescriptor retourne TRUE si elle réussit ; sinon, il retourne FALSE. Utilisez GetLastError pour obtenir des informations d’erreur étendues.
Remarques
Seules les applications en mode utilisateur peuvent appeler HidD_GetPhysicalDescriptor. Les pilotes en mode noyau peuvent utiliser une requête IOCTL_GET_PHYSICAL_DESCRIPTOR .
Pour plus d’informations, consultez Collections HID.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | hidsdi.h (inclure Hidsdi.h) |
| Bibliothèque | Hid.lib |
| DLL | Hid.dll |