Partager via

HidD_GetFeature, fonction (hidsdi.h)

  • Article

La routine HidD_GetFeature retourne un rapport de fonctionnalité à partir d’une collection de niveau supérieur spécifiée.

Syntaxe

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Paramètres

[in] HidDeviceObject

Handle ouvert à une collection de niveau supérieur.

[out] ReportBuffer

Pointeur vers une mémoire tampon de rapport HID allouée par l’appelant que l’appelant utilise pour spécifier un ID de rapport. HidD_GetFeature utilise ReportBuffer pour retourner le rapport de fonctionnalité spécifié.

Pour plus d’informations sur ce paramètre, consultez la section Remarques .

[in] ReportBufferLength

Taille de la mémoire tampon de rapport en octets. La mémoire tampon de rapport doit être suffisamment grande pour contenir le rapport de fonctionnalité plus un octet supplémentaire qui spécifie un ID de rapport différent de zéro. Si l’ID de rapport n’est pas utilisé, la valeur de l’ID est zéro.

Valeur retournée

Si HidD_GetFeature réussit, elle retourne TRUE ; sinon, elle retourne FALSE. Utilisez GetLastError pour obtenir des informations d’erreur étendues.

Remarques

Le Bon ReportBufferLength est spécifié par le membre FeatureReportByteLength de la structure HIDP_CAPS d’une collection de niveau supérieur retournée par HidP_GetCaps appel.

Avant d’appeler la routine HidD_GetFeature , l’appelant doit effectuer les opérations suivantes :

  • Si la collection de niveau supérieur inclut des ID de rapport, l’appelant doit définir le premier octet du paramètre ReportBuffer sur un ID de rapport différent de zéro.
  • Si la collection de niveau supérieur n’inclut pas d’ID de rapport, l’appelant doit définir le premier octet du paramètre ReportBuffer sur zéro.

Le rapport de fonctionnalité est retourné dans le paramètre ReportBuffer . Selon l’ID de rapport, l’appelant analyse le rapport en appelant l’une des fonctions suivantes :

Pour obtenir un exemple d’analyse d’un rapport HID, consultez l’exemple d’application HClient . Cet exemple se trouve dans MSDN Code Gallery.

Seules les applications en mode utilisateur peuvent appeler HidD_GetFeature. Les pilotes en mode noyau peuvent utiliser une requête IOCTL_HID_GET_FEATURE .

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

Voir aussi