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

# PFMultiplayerSetThreadAffinityMask

> PFMultiplayerSetThreadAffinityMask 的参考，使用亲和性掩码将 PlayFab 多人游戏库的内部线程固定到特定 CPU 核心。

可选地配置内部多人游戏库线程将在其上运行的处理器。

## 语法

```cpp theme={null}
HRESULT PFMultiplayerSetThreadAffinityMask(  
    PFMultiplayerThreadId threadId,  
    uint64_t threadAffinityMask  
)  
```

### 参数

**`threadId`**   [PFMultiplayerThreadId](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid)

要配置处理器亲和性的内部多人游戏库线程的类型。

**`threadAffinityMask`**   uint64\_t

此类型的多人游戏库线程的亲和性掩码。

### 返回值

类型：HRESULT

如果调用成功，则返回 `S_OK`；否则返回错误代码。可通过 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 检索错误代码的可读形式。

## 备注

此方法使标题能够为特定类型的多人游戏库内部线程配置处理器亲和性。<br /><br /> 此方法可在 [PFMultiplayerInitialize()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize) 之前或之后的任何时候调用，并将立即生效。线程处理器设置在调用 [PFMultiplayerUninitialize()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize) 和 PFMultiplayerInitialize() 之后仍会保留。当存在超过 64 个核心时，此方法始终应用于处理器组 0。<br /><br /> 若要指定任何处理器，请将 `PFMultiplayerAnyProcessor` 作为 `threadAffinityMask` 参数传递。如果从未调用此方法，这也是多人游戏库将使用的默认值。

## 要求

**头文件：** PFMultiplayer.h

## 另请参阅

[PFMultiplayer 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerThreadId](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid)


## Related topics

- [PFMultiplayerThreadId](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid.md)
- [PFMultiplayerInitialize](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [异步 Lobby 和 Matchmaking C++ SDK 操作指南](/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [PFMultiplayer C/C++ API 概述 - PFMultiplayer.h](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)
- [chat_manager::set_thread_affinity_mask](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)