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

> Callback signature invoked when a LampArray peripheral changes status; registered through RegisterLampArrayStatusCallback in the GDK Lighting API.

# LampArrayStatusCallback

Title defined callback for LampArray status changed events. This function is registered with [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback).

## Syntax

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

### Parameters

*context*   \_In\_opt\_\
Type: void\*

A pointer to an object containing relevant information for the callback. This pointer was passed to [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback).

*currentStatus*\
Type: [LampArrayStatus](/reference/lighting/lamparray/enums/lamparraystatus)

The new status of the LampArray.

*previousStatus*\
Type: [LampArrayStatus](/reference/lighting/lamparray/enums/lamparraystatus)

The previous status of the LampArray.

*lampArray*   \_In\_\
Type: [ILampArray\*](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)

Device which triggered the callback.

### Return value

Type: void

## Remarks

This function's definition is determined by the developer, but the parameters of that function must match in order for the callback to occur. This function is used to define the LampArray device callback registered with [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback). It will define the function that is called whenever the LampArray status changes.

## Requirements

**Header:** LampArray.h

**Library:** xgameplatform.lib

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[Lighting API Overview](/build/core-features/common/lighting/gc-lighting-toc)\
[Lighting Basics](/build/core-features/common/lighting/lighting-basics)\
[RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback)\
[UnregisterLampArrayCallback](/reference/lighting/lamparray/functions/unregisterlamparraycallback)


## Related topics

- [RegisterLampArrayStatusCallback function](/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [LampArrayStatus enum reference](/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArrayCallback function reference](/reference/lighting/lamparray/functions/lamparraycallback.md)
- [RegisterLampArrayCallback function reference](/reference/lighting/lamparray/functions/registerlamparraycallback.md)
- [UnregisterLampArrayCallback function reference](/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)