fonction HidD_GetPhysicalDescriptor (hidsdi.h)

Article
02/26/2024

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