GetRawInputDeviceList

システムに接続されている生入力デバイスを列挙する。

GetRawInputDeviceList pRawInputDeviceList, puiNumDevices, cbSize

pRawInputDeviceList : [var] 型: PRAWINPUTDEVICELIST システムに接続されているデバイスの RAWINPUTDEVICELIST 構造体配列。NULL の場合、デバイス数が *puiNumDevices に返される。
puiNumDevices : [var] 型: PUINT pRawInputDeviceList が NULL の場合、この変数にはシステムに接続されているデバイス数が入る。そうでない場合は、pRawInputDeviceList が指すバッファに収容可能な RAWINPUTDEVICELIST 構造体の個数を指定する。この値が接続デバイス数より小さい場合、関数は実際のデバイス数をこの変数に返し ERROR_INSUFFICIENT_BUFFER で失敗する。この値が接続デバイス数以上の場合、値は変更されず、戻り値としてデバイス数が報告される。
cbSize : [int] 型: UINT RAWINPUTDEVICELIST 構造体のバイト単位のサイズ。

(プラグイン / モジュール : user32.dll)

解説

システムに接続されている生入力デバイスを列挙する。

[戻り値]
型: UINT 関数が成功した場合、戻り値は pRawInputDeviceList
が指すバッファに格納されたデバイス数である。その他のエラー時は (UINT)-1 を返し、GetLastError がエラーを示す。

[備考]
この関数が返すデバイスはマウス、キーボード、その他の HID
デバイスである。接続デバイスの詳細情報を取得するには、RAWINPUTDEVICELIST の hDevice を用いて
GetRawInputDeviceInfo を呼び出す。

情報