構文
パラメーター
info _Out_型: GameInputKeyboardInfo* デバイスのキーボードのプロパティを受け取る
GameInputKeyboardInfo 構造体へのポインター。デバイスがキーボード入力をサポートしていない場合、構造体のすべてのメンバーは 0 に設定されます。
戻り値
型: bool デバイスがキーボード入力をサポートしていて、info にデータが格納された場合はtrue。それ以外の場合は false。
解説
GetKeyboardInfo メソッドは、デバイスのキーボードのプロパティを、呼び出し元が用意した構造体にコピーします。GetSupportedInput から返される値に GameInputKindKeyboard が含まれている場合、そのデバイスはキーボード入力をサポートしています。デバイスがキーボード入力をサポートしていない場合、GetKeyboardInfo は info を 0 で初期化し、false を返します。
ほとんどのキーボードのプロパティはデバイスの有効期間中は固定されています。例外は layout メンバーで、アクティブなキーボード レイアウトが変更されると (たとえば、ユーザーが入力言語を切り替えたとき)、GameInput によってその場で更新されます。レイアウトが変更されると、GameInput は IGameInput::RegisterDeviceCallback で登録されたデバイス コールバックに対して GameInputDeviceEventKeyboardLayoutUpdated GameInputDeviceEvent を発生させます。新しいレイアウトを読み取るには、そのコールバック内から GetKeyboardInfo をもう一度呼び出します。
次の例は、デバイスのキーボードのプロパティをクエリする方法を示しています。
keyboardInfo メンバーから取得できました。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice