IOCTL_HID_GET_FEATURE control code

The IOCTL_HID_GET_FEATURE request obtains a feature report from a HIDClass device.

For general information about HIDClass devices, see HID Collections.

Input Parameters

Irp->UserBuffer points to a HID_XFER_PACKET structure that the HID class driver uses to input the following members:

reportBuffer

Points to a requester-allocated output buffer that a HID minidriver uses to return a feature report.

reportBufferLen

Specifies the size, in bytes, of the output buffer.

ReportID

Specifies a report ID associated with a top-level collection.

Output Parameters

((PHID_XFER_PACKET)(Irp->UserBuffer))->reportBuffer points to the requester-allocated output buffer that the HID minidriver uses to return a feature report.

I/O Status Block

HID minidrivers that carry out the I/O to the device set the following fields of Irp->IoStatus:

  • Information is set to the number of bytes transferred from the device.

  • Status is set to STATUS_SUCCESS if the transfer completed without error. Otherwise, it is set to an appropriate NTSTATUS error code.

HID minidrivers that call other drivers with this IOCTL to carry out the I/O to their device, should ensure that the Information field of the status block is correct and not change the contents of the Status field.

Requirements

Header

Hidclass.h (include Hidclass.h)

See also

HidD_GetFeature
HidD_GetInputReport
HidD_SetFeature
HidD_SetOutputReport
HID_XFER_PACKET
IOCTL_HID_GET_INPUT_REPORT
IOCTL_HID_READ_REPORT
IOCTL_HID_SET_FEATURE
IOCTL_HID_SET_OUTPUT_REPORT
IOCTL_HID_WRITE_REPORT

 

 

Send comments about this topic to Microsoft

Show: