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

# LampArrayEnumerationKind 枚举

> LampArrayEnumerationKind 枚举

# LampArrayEnumerationKind 枚举

描述新注册的 LampArrayStatusCallback 函数所期望的设备枚举行为。与 [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 一起使用时，此行为仅适用于注册时已连接的 LampArrays。

<a id="syntaxSection" />

## 语法

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

<a id="constantsSection" />

## 常量

| 常量       | 描述                                                                                                                                                                   |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Async    | 对 [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 的调用应立即返回，已连接 LampArrays 的枚举应在专用的 LampArray 回调工作线程上异步进行。 |
| Blocking | 对 [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 的调用应阻塞，直到所有已连接的 LampArrays 均被枚举完毕。                      |

<a id="remarksSection" />

## 备注

[RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 的 **LampArrayEnumerationKind** 参数允许调用方指定如何为在调用时已连接的 LampArray 设备接收回调。如果选择 **LampArrayEnumerationKind::Blocking**，RegisterLampArrayStatusCallback 函数将阻塞，直到对每个已连接设备都调用了该回调（这意味着回调将在调用线程上执行）。

在注册第一个回调时，LampArray API 会启动一个工作线程来处理 **ILampArray** 设备状态通知。这些事件并不频繁，工作线程在其他时间保持等待状态。注册调用返回后，所有后续的 LampArrayStatusCallbacks 将在此工作线程上按顺序执行。

如果指定 **LampArrayEnumerationKind::Async**，注册调用会立即返回，且调用时已连接的任何 LampArrays 将在前述 LampArray 回调工作线程上进行枚举。

<a id="requirementsSection" />

## 要求

**头文件：** 在 LampArray.h 中声明。

<a id="seealsoSection" />

## 另请参阅

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


## Related topics

- [LampArrayKind 枚举](/zh-CN/reference/lighting/lamparray/enums/lamparraykind.md)
- [RegisterLampArrayStatusCallback](/zh-CN/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [光照 API 参考](/zh-CN/reference/lighting/gc-reference-lighting-toc.md)
- [LampArray](/zh-CN/reference/lighting/lamparray/lamparray_members.md)
- [LampArrayStatus 枚举](/zh-CN/reference/lighting/lamparray/enums/lamparraystatus.md)