跳转到主要内容
获取输入设备在指定灯光组选择中的灯数量。

语法

参数

group
类型:GameInputLightingGroups
要统计其中灯数量的灯光组选择。可以是一个或多个命名组标志、GameInputLightingGroupAll 或 GameInputLightingGroupUnknown。

返回值

类型:uint32_t 所选范围中的灯数量。如果设备在所选范围中没有灯,或者 group 包含未定义的标志,则返回 0。

备注

group 的值按如下方式解释。 当你按序号对单个灯进行寻址时,所选范围的灯数量是 IGameInputDevice::SetLightingColor 的 groupOrderIndex 参数的上限(不含该值)。例外的是 GameInputLightingGroupKeyboardKey,它改为按键盘扫描码对单个灯进行寻址。 以下示例以不同深浅的绿色点亮正面按钮组中的每个灯。
灯数量在设备对象的生存期内不会更改。
灯光支持取决于设备和平台。目前,GameInput 支持 Windows 动态光效 (LampArray) 设备以及 DualSense 控制器灯条的灯光。

要求

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

另请参阅

GameInput 概述
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroups
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors

版本历史

最后修改于 2026年11月6日