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

# Enumeração LampArrayEnumerationKind

> Enumeração que controla se a enumeração inicial de LampArray em RegisterLampArrayStatusCallback é executada de forma assíncrona ou bloqueia até que todos os dispositivos se reportem.

# Enumeração LampArrayEnumerationKind

Descreve o comportamento desejado de enumeração de dispositivos de uma função LampArrayStatusCallback recém-registrada. Usado com [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md), esse comportamento se aplica apenas aos LampArrays conectados no momento do registro.

## Sintaxe

```cpp theme={null}
enum class LampArrayEnumerationKind : uint32_t
{
    Async       = 1,
    Blocking    = 2
};
```

## Constantes

| Constante | Descrição |
| - | - |
| Async | A chamada para [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) deve retornar imediatamente, e a enumeração dos LampArrays conectados deve ocorrer de forma assíncrona no thread de trabalho dedicado de retorno de chamada do LampArray. |
| Blocking | A chamada para [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) deve bloquear até que todos os LampArrays conectados tenham sido enumerados. |

## Comentários

O parâmetro **LampArrayEnumerationKind** de [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) permite que o chamador especifique como deve receber retornos de chamada para quaisquer dispositivos LampArray conectados no momento da chamada. Se **LampArrayEnumerationKind::Blocking** for selecionado, a função RegisterLampArrayStatusCallback bloqueará até que esse retorno de chamada seja invocado para cada dispositivo conectado (o que significa que o retorno de chamada será invocado no thread de chamada).

Quando o primeiro retorno de chamada é registrado, a API LampArray inicia um thread de trabalho para lidar com as notificações de status de dispositivos **ILampArray**. Esses eventos são pouco frequentes e, fora isso, o thread de trabalho permanece em estado de espera. Depois que a chamada de registro retorna, todos os LampArrayStatusCallbacks subsequentes serão invocados sequencialmente nesse thread de trabalho.

Se **LampArrayEnumerationKind::Async** for especificado, a chamada de registro retornará imediatamente, e quaisquer LampArrays conectados no momento da chamada serão enumerados no thread de trabalho de retorno de chamada do LampArray mencionado anteriormente.

## Requisitos

**Cabeçalho:** declarado em LampArray.h.

## 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)\
[RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)


## Related topics

- [Enumeração LampArrayKind](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparraykind.md)
- [RegisterLampArrayStatusCallback](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [Referência da API de iluminação (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/lighting/gc-reference-lighting-toc.md)
- [Noções básicas do LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-basics.md)
- [Enumeração LampArrayStatus](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)