IOCTL_HID_READ_REPORT IOCTL (hidport.h)

Artikel
03/05/2024

Permintaan IOCTL_HID_READ_REPORT mentransfer laporan input dari perangkat HIDClass ke buffer driver kelas HID.

Untuk informasi umum tentang perangkat HIDClass, lihat Koleksi HID.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Parameters.DeviceIoControl.OutputBufferLength berisi ukuran buffer yang disediakan di Irp-UserBuffer>.

Panjang buffer input

Ukuran OutputBufferLength

Buffer output

Minidriver HID mengisi buffer residen sistem yang ditujukkan oleh Irp-UserBuffer> dengan data laporan yang diambil dari perangkat.

Panjang buffer output

Ukuran UserBuffer.

Blok status

Minidriver HID yang melakukan I/O ke perangkat mengatur bidang Irp-IoStatus> berikut:

Informasi diatur ke jumlah byte yang ditransfer dari perangkat.
Status diatur ke STATUS_SUCCESS jika transfer selesai tanpa kesalahan. Jika tidak, ini diatur ke kode kesalahan NTSTATUS yang sesuai.

Minidriver HID yang memanggil driver lain dengan IRP ini untuk melakukan I/O ke perangkat mereka harus memastikan bahwa bidang Informasi blok status sudah benar dan tidak mengubah konten bidang Status .

Keterangan

IOCTL_HID_READ_REPORT biasanya digunakan untuk terus menyelesaikan laporan input yang dikirim oleh perangkat. IOCTL ini dikirim oleh driver kelas HID (HIDCLASS) dengan cara ping-pong. Dengan kata lain, segera setelah permintaan terpenuhi (selesai), yang lain dapat dikirim ke perangkat, memungkinkan pelaporan data berkelanjutan. Ini adalah mekanisme "asinkron", jadi misalnya, perangkat dapat menggunakannya untuk mengirim data ke host, mengenai perubahan status saat perubahan tersebut terjadi.