HidD_SetFeature函数 (hidsdi.h)

HidD_SetFeature 例程将功能报告发送到 顶级集合

语法

BOOLEAN HidD_SetFeature(
  [in] HANDLE HidDeviceObject,
  [in] PVOID  ReportBuffer,
  [in] ULONG  ReportBufferLength
);

参数

[in] HidDeviceObject

顶级集合的打开句柄。

[in] ReportBuffer

指向调用方分配的功能报表缓冲区的指针,调用方使用该缓冲区指定 HID 报表 ID。

有关此参数的详细信息,请参阅 备注 部分。

[in] ReportBufferLength

报表缓冲区的大小(以字节为单位)。 报表缓冲区必须足够大,才能保存功能报表以及一个指定非零报表 ID 的其他字节。 如果未使用报表 ID,则 ID 值为零。

返回值

如果 HidD_SetFeature 成功,则返回 true ;否则,它将返回 FALSE。 使用 GetLastError 获取扩展的错误信息。

言论

正确的 reportBufferLength 是由从 HidP_GetCaps 调用返回的顶级集合 HIDP_CAPS 结构的 FeatureReportByteLength 成员指定的。

在调用 HidD_SetFeature 例程之前,调用方必须执行以下作:

有关如何准备和 HID 报表并将其发送到 顶级集合的示例,请参阅 HClient 示例应用程序。

只有用户模式应用程序才能调用 HidD_SetFeature。 内核模式驱动程序可以使用 IOCTL_HID_SET_FEATURE 请求。

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows 中可用。
目标平台 普遍
标头 hidsdi.h (包括 Hidsdi.h)
Hid.lib
DLL Hid.dll

另请参阅