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