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

# Referência da 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](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback), esse comportamento se aplica apenas aos LampArrays conectados no momento do registro.

<a id="syntaxSection" />

## Sintaxe

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

<a id="constantsSection" />

## Constantes

| Constante | Descrição |
| - | - |
| Async | A chamada para [RegisterLampArrayStatusCallback](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 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](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback) deve bloquear até que todos os LampArrays conectados tenham sido enumerados. |

<a id="remarksSection" />

## Comentários

O parâmetro **LampArrayEnumerationKind** de [RegisterLampArrayStatusCallback](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 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.

<a id="requirementsSection" />

## Requisitos

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

<a id="seealsoSection" />

## Confira também

[Visão geral da API de iluminação](/pt-BR/build/core-features/common/lighting/gc-lighting-toc)\
[RegisterLampArrayStatusCallback](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback)


## Related topics

- [Referência da enumeração LampArrayKind](/pt-BR/reference/lighting/lamparray/enums/lamparraykind.md)
- [Referência da enumeração LampArrayStatus](/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)
- [Referência da API de iluminação para periféricos LampArray](/pt-BR/reference/lighting/gc-reference-lighting-toc.md)
- [Função RegisterLampArrayStatusCallback](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [Referência de membros da API LampArray](/pt-BR/reference/lighting/lamparray/lamparray_members.md)