HidD_GetPhysicalDescriptor関数 (hidsdi.h)

[アーティクル]
08/07/2023

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	hidsdi.h (Hidsdi.h を含む)
Library	Hid.lib
[DLL]	Hid.dll