HidD_GetPhysicalDescriptor函数 (hidsdi.h)

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

另请参阅

HidD_GetIndexedString

HidD_GetManufacturerString

HidD_GetProductString

HidD_GetSerialNumberString

IOCTL_GET_PHYSICAL_DESCRIPTOR