Partager via

fonction HidD_SetFeature (hidsdi.h)

  • Article

La routine HidD_SetFeature envoie un rapport de fonctionnalités à un collection de niveau supérieur.

Syntaxe

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

Paramètres

[in] HidDeviceObject

Handle ouvert à une collection de niveau supérieur.

[in] ReportBuffer

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

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és et 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 d’ID est égale à zéro.

Valeur de retour

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

Remarques

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

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

Pour obtenir un exemple de préparation et d’envoi d’un rapport HID à un collection de niveau supérieur, consultez l’exemple d’application HClient.

Seules les applications en mode utilisateur peuvent appeler HidD_SetFeature. Les pilotes en mode noyau peuvent utiliser une demande de IOCTL_HID_SET_FEATURE.

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

Voir aussi