HidD_GetPhysicalDescriptor 例程返回 顶级集合 标识集合物理设备的 物理描述符。
物理描述符 用于指示人体的物理部分用于激活设备上的控件。 例如,物理描述符 可能指示使用右手拇指激活按钮 5。
请注意,物理描述符 是完全可选的。 它们增加了复杂性,为大多数设备提供了很少的回报。 但是,某些设备(尤其是具有大量相同控件(例如按钮)的设备会发现,物理描述符 帮助不同的应用程序以更一致的方式将这些控件分配功能。 有关详细信息,请参阅 HID 规范。
语法
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
参数
[in] HidDeviceObject
指定顶级集合的打开句柄。
[out] Buffer
指向调用方分配的缓冲区的指针,该缓冲区的例程用于返回请求的物理描述符。
[in] BufferLength
指定缓冲区 缓冲区的长度(以字节为单位)。
返回值
HidD_GetPhysicalDescriptor 如果成功,则返回 true true;否则,它将返回 FALSE。 使用 GetLastError 获取扩展的错误信息。
言论
只有用户模式应用程序才能调用 HidD_GetPhysicalDescriptor。 内核模式驱动程序可以使用 IOCTL_GET_PHYSICAL_DESCRIPTOR 请求。
有关详细信息,请参阅 HID 集合。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows 2000 及更高版本的 Windows 中可用。 |
| 目标平台 | 普遍 |
| 标头 | hidsdi.h (包括 Hidsdi.h) |
| 库 | Hid.lib |
| DLL | Hid.dll |