目次 - SDL 3.0 API(機能別) - HIDAPI - SDL_hid_enumerate

SDL_hid_enumerate

HIDデバイスを列挙する

ヘッダ

SDL3/SDL_hidapi.h

構文

SDL_hid_device_info * SDL_hid_enumerate(unsigned short vendor_id, unsigned short product_id);

引数

unsigned shortvendor_idデバイスのベンダーID. 0のとき全てのベンダー
unsigned shortproduct_idデバイスのプロダクトID. 0のとき全てのプロダクト

戻り値

(SDL_hid_device_info *) システムに接続されたHIDの情報を含むSDL_hid_device_info型の連結リストへのポインタを, 失敗のときはNULLを戻す. 連結リストを解放するにはSDL_hid_free_enumeration()を呼ぶ.

詳細

この関数はvendor_idとproduct_idが一致するシステムに接続された全HIDデバイス情報の連結リストを戻す. vendor_idが0のとき全てのベンダーと一致する. product_idのとき全てのプロダクトと一致する. vendor_idとproduct_idの両方が0のとき, 全てのHIDデバイスを戻す.

不正なデバイスでハングまたはクラッシュするリスクを軽減するため, デフォルトではSDLはコントローラのみを列挙するが, SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERSに"0"を設定すると全てのHIDデバイスを列挙する.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_hid_enumerate - SDL Wiki