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

# GetLampInfo

> 依索引傳回描述 LampArray 上個別 Lamp 的 ILampInfo 物件，公開位置、色彩支援、用途和掃描碼。

# ILampArray::GetLampInfo

傳回位於指定索引之 Lamp 的 ILampInfo。

## 語法

```cpp theme={null}
HRESULT GetLampInfo(
    uint32_t lampIndex,
    ILampInfo** lampInfo)
```

### 參數

*lampIndex*\
類型：uint32\_t

ILampArray 中要取得 ILampInfo 的所需索引。

*lampInfo*  \_COM\_Outptr\_\
類型：ILampInfo\*\*

對應至 lampIndex 的 ILampInfo。如果 lampIndex 大於或等於 [ILampArray::GetLampCount](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount.md)，此值將為 null；

### 傳回值

類型：HRESULT

函式結果。

## 備註

[ILampInfo](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md) 包含 ILampArray 中指定索引處之 Lamp 的相關屬性。

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[照明 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)\
[ILampInfo](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)


## Related topics

- [GetIndex](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getindex.md)
- [LampArray 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)
- [ILampArray (介面內容)](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [GetNearestSupportedColor](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getnearestsupportedcolor.md)
- [GetPosition](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getposition.md)