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

# LampArrayCallback 函式參考

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

# LampArrayCallback

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

## 語法

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

### 參數

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

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

*isAttached*\
類型：bool

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

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

觸發回呼的裝置。

### 傳回值

類型：void

## 備註

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


## Related topics

- [LampArrayCallback](/ja-jp/reference/lighting/lamparray/functions/lamparraycallback.md)
- [LampArrayCallback function reference](/reference/lighting/lamparray/functions/lamparraycallback.md)
- [Referencia de la función LampArrayCallback](/es/reference/lighting/lamparray/functions/lamparraycallback.md)
- [RegisterLampArrayCallback](/zh-CN/reference/lighting/lamparray/functions/registerlamparraycallback.md)
- [UnregisterLampArrayCallback](/ko/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)