Partager via


IOCTL_HID_GET_DEVICE_DESCRIPTOR IOCTL (hidport.h)

La requête IOCTL_HID_GET_DEVICE_DESCRIPTOR obtient le descripteur HID d’un appareil HIDClass.

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 contient la longueur de la mémoire tampon résidente du système fournie dans Irp-UserBuffer>.

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

Taille de OutputBufferLength.

Mémoire tampon de sortie

Le minidriver HID retourne le descripteur d’appareil dans la mémoire tampon utilisateur sur Irp-UserBuffer>.

Longueur de la mémoire tampon de sortie

Taille du descripteur d’appareil.

Bloc d’état

Les minidrivers HID qui effectuent les E/S sur l’appareil définissent les champs suivants d’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 cette IRP 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_ATTRIBUTES

IOCTL_HID_GET_REPORT_DESCRIPTOR