目次 - SDL 3.0 API(機能別) - キーボード - SDL_GetKeyboards

SDL_GetKeyboards

現在接続されているキーボードの一覧を得る

ヘッダ

SDL3/SDL_keyboard.h

構文

SDL_KeyboardID * SDL_GetKeyboards(int *count);

引数

int *countキーボードの数の代入先へのポインタ. NULLも可

戻り値

(SDL_KeyboardID *) 0が終端のキーボードインスタンスIDの配列を戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる. 不要になったときSDL_free()で解放する必要がある.

詳細

この一覧には, 一部のマウス, KVMスイッチ, マザーボードの電源ボタンなどのキーボードの機能のある全てのデバイスや仮想ドライバが含まれているので注意すること. それが実際に使われているとみなすには, デバイスからの入力を待つべきである.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetKeyboards - SDL Wiki