> ## 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.

# LampArrayStatusCallback

> LampArray 周邊裝置變更狀態時叫用的回呼簽章；透過 GDK 照明 API 中的 RegisterLampArrayStatusCallback 註冊。

# LampArrayStatusCallback

由遊戲定義的回呼，用於 LampArray 狀態變更事件。此函式透過 [RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) 註冊。

## 語法

```cpp theme={null}
typedef void (CALLBACK * LampArrayStatusCallback)(
    _In_opt_ void * context,
    LampArrayStatus currentStatus,
    LampArrayStatus previousStatus,
    _In_ ILampArray * lampArray);
```

### 參數

*context*   \_In\_opt\_\
類型：void\*

指向物件的指標，該物件包含回呼的相關資訊。此指標已傳遞至 [RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)。

*currentStatus*\
類型：[LampArrayStatus](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/enums/lamparraystatus.md)

LampArray 的新狀態。

*previousStatus*\
類型：[LampArrayStatus](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/enums/lamparraystatus.md)

LampArray 先前的狀態。

*lampArray*   \_In\_\
類型：[ILampArray\*](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)

觸發回呼的裝置。

### 傳回值

類型：void

## 備註

此函式的定義由開發人員決定，但該函式的參數必須相符，回呼才會發生。此函式用於定義透過 [RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) 註冊的 LampArray 裝置回呼。它會定義每當 LampArray 狀態變更時所呼叫的函式。

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

[照明 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/gc-lighting-toc.md)\
[照明基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)\
[RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)\
[UnregisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)


## Related topics

- [RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [LampArrayStatus 列舉](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArrayEnumerationKind 列舉](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [LampArray 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)
- [TrySetLampArrayWorkerThreadAffinityMask](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/trysetlamparrayworkerthreadaffinitymask.md)