> ## 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 Multiplayer 程式庫執行緒固定至特定 CPU 核心。

選擇性地設定內部 Multiplayer 程式庫執行緒將在哪個處理器上執行。

## 語法

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

### 參數

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

要設定處理器親和性的內部 Multiplayer 程式庫執行緒類型。

**`threadAffinityMask`**   uint64\_t

此類型 Multiplayer 程式庫執行緒的親和性遮罩。

### 傳回值

類型：HRESULT

如果呼叫成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

此方法可讓遊戲為指定類型的內部 Multiplayer 程式庫執行緒設定處理器親和性。<br /><br /> 此方法可以在 [PFMultiplayerInitialize()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize) 之前或之後隨時呼叫，並會立即生效。執行緒處理器設定會在 [PFMultiplayerUninitialize()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize) 和 PFMultiplayerInitialize() 呼叫之間保存。當存在超過 64 個核心時，此方法一律套用至處理器群組 0。   <br /><br /> 若要指定任何處理器，請傳遞 `PFMultiplayerAnyProcessor` 作為 `threadAffinityMask` 參數。這也是在從未呼叫此方法時 Multiplayer 程式庫將使用的預設值。

## 需求

**標頭：** PFMultiplayer.h

## 另請參閱

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


## Related topics

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