Initialisation des rapports IHM

Cet article décrit comment les applications en mode utilisateur et les pilotes en mode noyau initialisent un rapport HID avant d’utiliser les routines de prise en charge HIDClass ou les IOCTLs du pilote de classe HID.

Pour initialiser une mémoire tampon de rapport, une application ou un pilote crée une mémoire tampon initialisée zéro de la taille requise, en octets, pour le type de rapport. Les membres XxxReportByteLength de la structure HIDP_CAPS d’une collection HID spécifient la taille requise des rapports d’entrée, de sortie et de fonctionnalité. Après avoir initialisé une mémoire tampon de rapport, une application ou un pilote peut utiliser HidP_Setroutines Xxx pour définir des données de contrôle dans le rapport. Lors de la première utilisation d’un rapport, les routines HidP_SetXxx définissent l’ID de rapport sur celui associé à une utilisation HID spécifiée. Si l’application ou le pilote tente par la suite de définir une utilisation incompatible avec l’ID de rapport, les routines HidP_SetXxx retournent un état de HIDP_STATUS_INCOMPATIBLE_REPORT_ID.