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 コレクション」を参照してください。

要件

こちらもご覧ください

HidD_GetIndexedString

HidD_GetManufacturerString

HidD_GetProductString

HidD_GetSerialNumberString

IOCTL_GET_PHYSICAL_DESCRIPTOR