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

指定 Buffer 处缓冲区的长度（以字节为单位）。

如果成功，则HidD_GetPhysicalDescriptor 返回 TRUE ;否则返回 FALSE。使用 GetLastError 获取扩展错误信息。

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

有关详细信息，请参阅 HID 集合。