The HidD_SetFeature routine sends a feature report to a top-level collection.
BOOLEAN __stdcall HidD_SetFeature( _In_ HANDLE HidDeviceObject, _In_ PVOID ReportBuffer, _In_ ULONG ReportBufferLength );
- HidDeviceObject [in]
Specifies an open handle to a top-level collection.
- ReportBuffer [in]
Pointer to a caller-allocated feature report buffer that the caller uses to specify a HID report ID.
For more information about this parameter, see the Remarks section.
- ReportBufferLength [in]
Specifies the size, in bytes, of the report buffer. The report buffer must be large enough to hold the feature report -- excluding its report ID, if report IDs are used -- plus one additional byte that specifies a nonzero report ID or zero.
If HidD_SetFeature succeeds, it returns TRUE; otherwise, it returns FALSE.
Before it calls the HidD_SetFeature routine, the caller must do the following:
If the top-level collection includes report IDs, the caller must set the first byte of the ReportBuffer parameter to a nonzero report ID.
If the top-level collection does not include report IDs, the caller must set the first byte of the ReportBuffer parameter to zero.
The feature report is referenced by the ReportBuffer parameter. Depending on the report ID, the caller prepares the report by calling one of the following functions:
Only user-mode applications can call HidD_SetFeature. Kernel-mode drivers can use an IOCTL_HID_SET_OUTPUT_REPORT request.
For more information, see the following topics:
|Available in Windows 2000 and later versions of Windows.|