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

> LampArrayStatusCallback

# LampArrayStatusCallback

用于 LampArray 状态变化事件的、由标题定义的回调。此函数通过 [RegisterLampArrayStatusCallback](/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](/reference/lighting/lamparray/functions/registerlamparraystatuscallback)。

*currentStatus*\
类型：[LampArrayStatus](/reference/lighting/lamparray/enums/lamparraystatus)

LampArray 的新状态。

*previousStatus*\
类型：[LampArrayStatus](/reference/lighting/lamparray/enums/lamparraystatus)

LampArray 之前的状态。

*lampArray*   \_In\_\
类型：[ILampArray\*](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)

触发该回调的设备。

### 返回值

类型：void

## 备注

此函数的定义由开发者决定，但函数的参数必须匹配才能使回调发生。此函数用于定义通过 [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 注册的 LampArray 设备回调。它将定义每当 LampArray 状态发生变化时被调用的函数。

## 要求

**头文件：** LampArray.h

**库：** xgameplatform.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[光照 API 概览](/build/core-features/common/lighting/gc-lighting-toc)\
[光照基础](/build/core-features/common/lighting/lighting-basics)\
[RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback)\
[UnregisterLampArrayCallback](/reference/lighting/lamparray/functions/unregisterlamparraycallback)


## Related topics

- [RegisterLampArrayStatusCallback](/zh-CN/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [LampArrayStatus 枚举](/zh-CN/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArrayEnumerationKind 枚举](/zh-CN/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [光照 API 参考](/zh-CN/reference/lighting/gc-reference-lighting-toc.md)
- [LampArrayCallback](/zh-CN/reference/lighting/lamparray/functions/lamparraycallback.md)