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.
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 descripteurs physiques sont entièrement facultatifs. Ils ajoutent de la complexité et offrent très peu de retour pour la plupart des appareils. Toutefois, certains appareils, en particulier ceux dotés d’un grand nombre de contrôles identiques (par exemple, des boutons) trouvent que descripteurs physiques aider 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 dans une collection de niveau supérieur.
[out] Buffer
Pointeur vers une mémoire tampon allouée par 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 à tampon .
Valeur de retour
HidD_GetPhysicalDescriptor retourne TRUE si elle réussit ; sinon, elle 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | hidsdi.h (include Hidsdi.h) |
| bibliothèque | Hid.lib |
| DLL | Hid.dll |