メインコンテンツへスキップ
デバイスが備えているモーション センサーや方位センサーなど、デバイスのセンサーのプロパティを取得します。

構文

パラメーター

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

戻り値

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

解説

GetSensorsInfo メソッドは、デバイスのセンサーのプロパティを、呼び出し元が用意した構造体にコピーします。GetSupportedInput から返される値に GameInputKindSensors が含まれている場合、そのデバイスはセンサー入力をサポートしています。デバイスがセンサー入力をサポートしていない場合、GetSensorsInfo は info を 0 で初期化し、false を返します。 supportedSensors メンバーは GameInputSensorsKind フラグの組み合わせで、デバイス上のセンサーを示します。センサーの状態は、IGameInputReading::GetSensorsState を使用して読み取りから取得します。 このメソッドによって返されるプロパティはデバイスの有効期間中は固定されているため、一度 (たとえば、デバイスの接続時に) クエリを実行して結果をキャッシュできます。 次の例は、デバイスのセンサーのプロパティをクエリする方法を示しています。
GameInput v3 以前では、この情報は IGameInputDevice::GetDeviceInfo から返される GameInputDeviceInfo 構造体の sensorsInfo メンバーから取得できました。

要件

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

関連項目

GameInput の概要
GameInputSensorsInfo
GetSupportedInput
GameInputKind
GameInputSensorsKind
IGameInputReading::GetSensorsState
IGameInputDevice

バージョン履歴

最終更新日 2026年11月6日