IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)
La requête IOCTL_HID_GET_COLLECTION_INFORMATION obtient une structure de HID_COLLECTION_INFORMATION de la collection de niveau supérieur. Ces informations incluent la taille, en octets, des données préparées d’une collection.
Pour obtenir des informations générales sur les appareils HIDClass, consultez collections HID.
Code principal
Mémoire tampon d’entrée
Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de pile d’E/S de l’IRP indique la taille, en octets, de la mémoire tampon de sortie, qui doit être >= sizeof(HID_COLLECTION_INFORMATION).
Longueur de la mémoire tampon d’entrée
Supérieur ou égal à taille de(HID_COLLECTION_INFORMATION).
Mémoire tampon de sortie
Irp->AssociatedIrp.SystemBuffer pointe vers une mémoire tampon qui recevra les informations de collecte. Ces données seront mises en forme dans la mémoire tampon fournie par l’demandeur sous la forme d’une structure HID_COLLECTION_INFORMATION.
Longueur de la mémoire tampon de sortie
Taille d’une structure HID_COLLECTION_INFORMATION.
Bloc d’état
Le pilote de classe HID définit les champs suivants de Irp->IoStatus:
- Informations est définie sur taille de(HID_COLLECTION_INFORMATION) si les données ont été récupérées avec succès.
- 'état est défini sur STATUS_SUCCESS si le transfert s’est terminé sans erreur. Sinon, il est défini sur un code d’erreur NTSTATUS approprié.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | hidclass.h (include Hidclass.h) |