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

# LampArrayStatusCallback 函式參考

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

# LampArrayStatusCallback

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

## 語法

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

### 參數

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

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

*currentStatus*\
類型：[LampArrayStatus](/zh-TW/reference/lighting/lamparray/enums/lamparraystatus)

LampArray 的新狀態。

*previousStatus*\
類型：[LampArrayStatus](/zh-TW/reference/lighting/lamparray/enums/lamparraystatus)

LampArray 先前的狀態。

*lampArray*   \_In\_\
類型：[ILampArray\*](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)

觸發回呼的裝置。

### 傳回值

類型：void

## 備註

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

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

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

## 另請參閱

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


## Related topics

- [LampArrayStatusCallback](/ja-jp/reference/lighting/lamparray/functions/lamparraystatuscallback.md)
- [LampArrayStatusCallback function reference](/reference/lighting/lamparray/functions/lamparraystatuscallback.md)
- [Referencia de la función LampArrayStatusCallback](/es/reference/lighting/lamparray/functions/lamparraystatuscallback.md)
- [RegisterLampArrayStatusCallback function](/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [RegisterLampArrayStatusCallback](/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)