IGameInputDevice::GetSensorsInfo

检索设备的传感器属性，例如设备具有哪些运动传感器和方向传感器。

语法

bool GetSensorsInfo(
    GameInputSensorsInfo* info
);

参数

info _Out_
类型：GameInputSensorsInfo* 指向 GameInputSensorsInfo 结构的指针，该结构接收设备的传感器属性。如果设备不支持传感器输入，则该结构的每个成员都设置为零。

返回值

类型：bool 如果设备支持传感器输入并且已填充 info，则为 true；否则为 false。

备注

GetSensorsInfo 方法将设备的传感器属性复制到调用方提供的结构中。当 GetSupportedInput 返回的值包含 GameInputKindSensors 时，设备支持传感器输入。如果设备不支持传感器输入，GetSensorsInfo 会将 info 零初始化并返回 false。 supportedSensors 成员是 GameInputSensorsKind 标志的组合，用于标识设备上的传感器。传感器状态通过 IGameInputReading::GetSensorsState 从读数中读取。此方法返回的属性在设备的生存期内是固定的，因此你可以只查询一次（例如在设备连接时）并缓存结果。以下示例演示如何查询设备的传感器属性。

GameInputSensorsInfo info;
if (device->GetSensorsInfo(&info))
{
    if (info.supportedSensors & GameInputSensorsGyrometer)
    {
        // Enable gyro aiming.
    }
}

在 GameInput v3 及更早版本中，此信息可从 IGameInputDevice::GetDeviceInfo 返回的 GameInputDeviceInfo 结构的 sensorsInfo 成员中获取。

要求

头文件： GameInput.h 库： gameinput.lib 支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
GameInputSensorsInfo
GetSupportedInput
GameInputKind
GameInputSensorsKind
IGameInputReading::GetSensorsState
IGameInputDevice

版本历史

版本	变更
v4	引入。

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

语法

参数

返回值

备注

要求

另请参阅

版本历史

​语法

​参数

​返回值

​备注

​要求

​另请参阅

​版本历史

语法

参数

返回值

备注

要求

另请参阅

版本历史