IOCTL_HID_READ_REPORT IOCTL(hidport.h)

아티클
08/07/2023

IOCTL_HID_READ_REPORT 요청은 HIDClass 디바이스에서 HID 클래스 드라이버의 버퍼로 입력 보고서를 전송합니다.

HIDClass 디바이스에 대한 일반적인 내용은 HID 컬렉션을 참조하세요.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

Parameters.DeviceIoControl.OutputBufferLength는 Irp-UserBuffer>에 제공된 버퍼의 크기를 포함합니다.

입력 버퍼 길이

OutputBufferLength의 크기

출력 버퍼

HID 미니드라이버가 Irp-UserBuffer>가 가리키는 시스템 상주 버퍼를 디바이스에서 검색된 보고서 데이터로 채웁니다.

출력 버퍼 길이

UserBuffer의 크기입니다.

상태 블록

디바이스에 대한 I/O를 수행하는 HID 미니 드라이버는 Irp-IoStatus>의 다음 필드를 설정합니다.

정보는 디바이스에서 전송된 바이트 수로 설정됩니다.
전송이 오류 없이 완료된 경우 상태가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드로 설정됩니다.

디바이스에 I/O를 수행하기 위해 이 IRP를 사용하여 다른 드라이버를 호출하는 HID 미니드라이버에서는 상태 블록의 정보 필드가 올바른지 확인하고 상태 필드의 내용을 변경하지 않아야 합니다.

설명

IOCTL_HID_READ_REPORT 일반적으로 디바이스에서 보낸 입력 보고서를 지속적으로 완료하는 데 사용됩니다. 이 IOCTL은 HID 클래스 드라이버(HIDCLASS)에 의해 탁구 방식으로 전송됩니다. 즉, 요청이 처리(완료)되는 즉시 다른 요청을 디바이스로 전송하여 데이터를 지속적으로 보고할 수 있습니다. 이는 "비동기" 메커니즘이므로, 예를 들어 디바이스는 이러한 변경이 발생할 때 상태 변경과 관련하여 이를 사용하여 호스트에 데이터를 보낼 수 있습니다.