IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

La demande IOCTL_GET_PHYSICAL_DESCRIPTOR obtient le descripteur physique d’une collection de niveau supérieur. Pour un minidriver, ce descripteur est le descripteur de l’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 dans l’emplacement de la pile d’E/S de l’IRP indique la taille, en octets, de la mémoire tampon de sortie.

Mémoire tampon de sortie

Irp->MdlAddress doit pointer vers la mémoire tampon qui recevra le descripteur physique.

Le minidriver HID copie le descripteur physique dans la mémoire tampon utilisateur sur Irp-UserBuffer>.

Bloc d’état

Le pilote de classe HID définit le membre Status de Irp-IoStatus> 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 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 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	hidclass.h (inclure Hidclass.h)

Voir aussi

HidD_GetPhysicalDescriptor