Partager via

IOCTL_HID_GET_REPORT_DESCRIPTOR IOCTL (hidport.h)

  • Article

La demande 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 sur 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 sur 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 effectuent les E/S sur l’appareil définissent les champs suivants de Irp-IoStatus> :

  • Les informations sont définies sur le nombre d’octets transférés à partir de l’appareil.
  • 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é.
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 Informations du bloc status est correct et ne pas modifier le contenu du champ État.

Configuration requise

Condition requise Valeur
En-tête hidport.h (inclure Hidport.h)

Voir aussi

IOCTL_GET_PHYSICAL_DESCRIPTOR

IOCTL_HID_GET_DEVICE_DESCRIPTOR