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

SDL_hid_device_change_count

デバイスが追加または削除された可能性があるごとに増加するカウンタの値を得る

ヘッダ

SDL3/SDL_hidapi.h

構文

Uint32 SDL_hid_device_change_count(void);

戻り値

(Uint32) デバイス数が変化した可能性があるごとに増加するカウンタの値を戻す. デバイス数の変化の検知を利用できないとき0を戻す.

詳細

HIDデバイスの一覧を得るのは高コストである. この関数を呼ぶと, 最後に読んだときから変化したシステムのデバイスの数を得られる. 戻り値が変化しても何かが変わったとは限らない. しかし, そのときSDL_hid_enumerate()を呼んでデバイス一覧を更新できる.

この関数を最初に呼んだとき, デバイスの変化を追跡するためにスレッドやシステムリソースが確保される.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_hid_device_change_count - SDL Wiki