> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ILampInfo

> ILampInfo

# ILampInfo

单个可寻址 Lamp 及其属性的表示。此对象上的方法提供有关 Lamp 相对位置、颜色支持、预期用途以及关联键盘扫描代码（如适用）的信息。

## 语法

```cpp theme={null}
class ILampInfo : public IUnknown  
```

## 方法

| 方法                                                                                                                                    | 描述                                          |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| [GetBlueLevelCount](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getbluelevelcount)                           | 返回可为 Lamp 设置的蓝色强度数量。                        |
| [GetFixedColor](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getfixedcolor)                                   | 返回 Lamp 是否具有固定颜色。                           |
| [GetGainLevelCount](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getgainlevelcount)                           | 返回可为此 Lamp 设置的与颜色无关的强度数量。                   |
| [GetGreenLevelCount](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getgreenlevelcount)                         | 返回可为 Lamp 设置的蓝色强度数量。                        |
| [GetIndex](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getindex)                                             | 返回指定 Lamp 在 LampArray 中所处的索引。               |
| [GetNearestSupportedColor](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getnearestsupportedcolor)             | 相对于所需颜色，查找此 Lamp 支持的最接近/最匹配的颜色。             |
| [GetPosition](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getposition)                                       | 返回 Lamp 相对于 LampArray 边界框原点的 3D 位置。         |
| [GetPurposes](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)                                       | 返回 Lamp 预期用于的用途集合。                          |
| [GetRedLevelCount](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getredlevelcount)                             | 返回可为 Lamp 设置的红色强度数量。                        |
| [GetScanCode](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getscancode)                                       | 返回与此 Lamp 关联的键盘扫描代码。                        |
| [GetUpdateLatencyInMicroseconds](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getupdatelatencyinmicroseconds) | 返回从 LampArray 收到某个 Lamp 的更新到该更新从设备上发出的时间间隔。 |

## 要求

**头文件：** LampArray.h

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[光照 API 概览](/build/core-features/common/lighting/gc-lighting-toc)\
[光照基础](/build/core-features/common/lighting/lighting-basics)\
[LampArray](/reference/lighting/lamparray/lamparray_members)


## Related topics

- [ILampInfo::GetIndex](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getindex.md)
- [ILampInfo::GetPosition](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getposition.md)
- [ILampInfo::GetPurposes](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)
- [ILampInfo::GetNearestSupportedColor](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getnearestsupportedcolor.md)
- [ILampInfo::GetFixedColor](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getfixedcolor.md)