IOCTL_HID_GET_INPUT_REPORT IOCTL (hidclass.h)
La richiesta di IOCTL_HID_GET_INPUT_REPORT ottiene un report di input da un raccolta di primo livello.
Per informazioni generali sui dispositivi HIDClass, vedere raccolte HID.
Codice principale
Buffer di input
Il membro Parameters.DeviceIoControl.OutputBufferLength specifica le dimensioni di un buffer di output allocato dal richiedente in byte. Il driver di classe HID usa questo buffer per restituire un report di input.
Se la raccolta include ID report, il richiedente deve impostare il primo byte del buffer di output su un ID report diverso da zero. In caso contrario, il richiedente deve impostare il primo byte del buffer di output su zero.
minidriver che gestisce
Irp->UserBuffer punta a una struttura HID_XFER_PACKET usata dal driver di classe HID per immettere i membri seguenti:
Lunghezza del buffer di input
Dimensione del buffer in byte. Il buffer deve essere sufficientemente grande da contenere il report di input più un byte aggiuntivo che specifica un ID report diverso da zero. Se l'ID del report non viene usato, il valore ID è zero.
Buffer di output
Il membro Irp->MdlAddress punta al buffer di output allocato dal richiedente usato dal driver di classe HID per restituire il report di input. Il primo byte del buffer, usato dal richiedente per immettere un ID report o zero, rimane invariato. Il report di input viene restituito in ((PUCHAR)Irp->MdlAddress + 1).
minidriver che gestisce
((PHID_XFER_PACKET)(Irp->UserBuffer))->reportBuffer punta al buffer di output allocato dal richiedente usato dal minidriver HID per restituire il report di input.
Lunghezza del buffer di output
Dimensioni del report di output.
Blocco di stato
Il driver di classe HID imposta i campi seguenti di Irp->IoStatus:
- informazioni è impostata su zero.
- stato è impostato su STATUS_SUCCESS se il trasferimento è stato completato senza errori. In caso contrario, è impostato su un codice di errore NTSTATUS appropriato.
minidriver che gestisce
I minidriver HID che eseguono l'I/O nel dispositivo impostano i campi seguenti di Irp->IoStatus:
- informazioni è impostato sul numero di byte trasferiti dal dispositivo.
- stato è impostato su STATUS_SUCCESS se il trasferimento è stato completato senza errori. In caso contrario, è impostato su un codice di errore NTSTATUS appropriato.
I minidriver HID che chiamano altri driver con questo IOCTL per eseguire l'I/O nel dispositivo, devono assicurarsi che il campo informazioni del blocco di stato sia corretto e non modificare il contenuto del campo stato.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | hidclass.h (include Hidclass.h) |