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

# TrySetLampArrayWorkerThreadAffinityMask

> 為分派 LampArrayCallback 和 LampArrayStatusCallback 叫用的 LampArray 背景工作執行緒設定處理器親和性遮罩。

# TrySetLampArrayWorkerThreadAffinityMask

為 LampArray 背景工作執行緒設定處理器親和性遮罩。

## 語法

```cpp theme={null}
HRESULT TrySetLampArrayWorkerThreadAffinityMask(
    uint64_t threadAffinityMask);
```

### 參數

*threadAffinityMask*
類型：uint64\_t

LampArray 背景工作執行緒所需的親和性遮罩。

### 傳回值

類型：HRESULT

函式結果。

## 備註

此函式每個處理序最多只會成功並生效一次。不支援在同一個處理序內多次呼叫此函式。

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[照明 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/gc-lighting-toc.md)\
[LampArray 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)\
[SetThreadAffinityMask](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-setthreadaffinitymask)


## Related topics

- [LampArray API 成員](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/lamparray_members.md)
- [LampArray 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)
- [set_thread_affinity_mask](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)
- [get_thread_affinity_mask](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_affinity_mask.md)
- [PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)