メインコンテンツへスキップ
サポートされているボタン、サンプル レート、スクロール ホイールなど、デバイスのマウスのプロパティを取得します。

構文

パラメーター

info   _Out_
型: GameInputMouseInfo*
デバイスのマウスのプロパティを受け取る GameInputMouseInfo 構造体へのポインター。デバイスがマウス入力をサポートしていない場合、構造体のすべてのメンバーは 0 に設定されます。

戻り値

型: bool デバイスがマウス入力をサポートしていて、info にデータが格納された場合は true。それ以外の場合は false。

解説

GetMouseInfo メソッドは、デバイスのマウスのプロパティを、呼び出し元が用意した構造体にコピーします。GetSupportedInput から返される値に GameInputKindMouse が含まれている場合、そのデバイスはマウス入力をサポートしています。デバイスがマウス入力をサポートしていない場合、GetMouseInfo は info を 0 で初期化し、false を返します。 supportedButtons メンバーはマウスが備えている GameInputMouseButtons を報告し、hasWheelX メンバーと hasWheelY メンバーはマウスに水平スクロール ホイールと垂直スクロール ホイールがあるかどうかを報告します。マウスの状態は、IGameInputReading::GetMouseState を使用して読み取りから取得します。 このメソッドによって返されるプロパティはデバイスの有効期間中は固定されているため、一度 (たとえば、デバイスの接続時に) クエリを実行して結果をキャッシュできます。 次の例は、デバイスのマウスのプロパティをクエリする方法を示しています。
GameInput v3 以前では、この情報は IGameInputDevice::GetDeviceInfo から返される GameInputDeviceInfo 構造体の mouseInfo メンバーから取得できました。

要件

ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体

関連項目

GameInput の概要
GameInputMouseInfo
GetSupportedInput
GameInputKind
GameInputMouseButtons
IGameInputReading::GetMouseState
IGameInputDevice

バージョン履歴

最終更新日 2026年11月6日