Partager via


IOCTL_HID_GET_REPORT_DESCRIPTOR IOCTL (hidport.h)

La requête IOCTL_HID_GET_REPORT_DESCRIPTOR obtient le descripteur de rapport pour un appareil HIDClass.

Pour obtenir des 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 spécifie la longueur, en octets, de la mémoire tampon verrouillée à Irp->UserBuffer.

Longueur de la mémoire tampon d’entrée

Taille de OutputBufferLength.

Mémoire tampon de sortie

Le minidriver HID remplit la mémoire tampon à Irp->UserBuffer avec le descripteur de rapport.

Longueur de la mémoire tampon de sortie

Taille du descripteur de rapport.

Bloc d’état

Les minidrivers HID qui exécutent les E/S sur l’appareil définissent les champs suivants de Irp->IoStatus:

  • Informations est définie sur le nombre d’octets transférés à partir de l’appareil.
  • 'é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é.
Les minidrivers HID qui appellent d’autres pilotes avec ce IOCTL pour effectuer les E/S sur leur appareil, doivent s’assurer que le champ Information du bloc d’état est correct et ne modifie pas le contenu du champ Status.

Exigences

Exigence Valeur
d’en-tête hidport.h (include Hidport.h)

Voir aussi

IOCTL_GET_PHYSICAL_DESCRIPTOR

IOCTL_HID_GET_DEVICE_DESCRIPTOR