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 集合。