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

# LampArrayStatusCallback

> Assinatura de retorno de chamada invocada quando um periférico LampArray muda de status; registrada por meio de RegisterLampArrayStatusCallback na API de iluminação do GDK.

# LampArrayStatusCallback

Retorno de chamada definido pelo título para eventos de alteração de status de LampArray. Essa função é registrada com [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md).

## Sintaxe

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

### Parâmetros

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

Um ponteiro para um objeto que contém informações relevantes para o retorno de chamada. Esse ponteiro foi passado para [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md).

*currentStatus*\
Tipo: [LampArrayStatus](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)

O novo status do LampArray.

*previousStatus*\
Tipo: [LampArrayStatus](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)

O status anterior do LampArray.

*lampArray*   \_In\_\
Tipo: [ILampArray\*](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)

Dispositivo que disparou o retorno de chamada.

### Valor retornado

Tipo: void

## Comentários

A definição dessa função é determinada pelo desenvolvedor, mas os parâmetros dessa função devem corresponder para que o retorno de chamada ocorra. Essa função é usada para definir o retorno de chamada de dispositivo LampArray registrado com [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md). Ela definirá a função que é chamada sempre que o status do LampArray mudar.

## Requisitos

**Cabeçalho:** LampArray.h

**Biblioteca:** xgameplatform.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral da API de iluminação](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/gc-lighting-toc.md)\
[Noções básicas de iluminação](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-basics.md)\
[RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)\
[UnregisterLampArrayCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)


## Related topics

- [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [Enumeração LampArrayStatus](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)
- [Noções básicas do LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-basics.md)
- [Enumeração LampArrayEnumerationKind](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [TrySetLampArrayWorkerThreadAffinityMask](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/trysetlamparrayworkerthreadaffinitymask.md)