IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)

La requête IOCTL_HID_GET_COLLECTION_INFORMATION obtient la structure HID_COLLECTION_INFORMATIONd’une collection de niveau supérieur. Ces informations incluent la taille, en octets, des données préparées d’une collection.

Pour plus d’informations générales sur les appareils HIDClass, consultez Collections HID.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de la 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 à sizeof(HID_COLLECTION_INFORMATION).

Mémoire tampon de sortie

Irp->AssociatedIrp.SystemBuffer pointe vers une mémoire tampon qui recevra les informations de collection. Ces données seront mises en forme dans la mémoire tampon fournie par le demandeur en tant que 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 d’Irp-IoStatus> :

• Les informations sont définies sur sizeof(HID_COLLECTION_INFORMATION) si les données ont été récupérées avec succès.
• L’é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é.

Configuration requise

Voir aussi

HID_COLLECTION_INFORMATION