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

# LampArrayCallback

> 連接或中斷連接 LampArray 周邊裝置時叫用的回呼簽章；透過 GDK 照明 API 中的 RegisterLampArrayCallback 註冊。

# LampArrayCallback

由遊戲定義的回呼，用於 LampArray 連線和中斷連線事件。此函式透過 [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md) 註冊。

## 語法

```cpp theme={null}
typedef void (CALLBACK * LampArrayCallback)(
    void * context,
    bool isAttached,
    ILampArray * lampArray);  
```

### 參數

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

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

*isAttached*\
類型：bool

指出 LampArray 是否已連接到系統。

*lampArray*   \_In\_\
類型：ILampArray\*

觸發回呼的裝置。

### 傳回值

類型：void

## 備註

此函式的定義由開發人員決定，但該函式的參數必須相符，回呼才會發生。此函式用於定義透過 [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.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)\
[RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md)\
[UnregisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)


## Related topics

- [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md)
- [UnregisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)
- [LampArray API 成員](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/lamparray_members.md)
- [TrySetLampArrayWorkerThreadAffinityMask](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/trysetlamparrayworkerthreadaffinitymask.md)
- [LampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/lamparraystatuscallback.md)