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

# PFMultiplayerSetThreadAffinityMask

> 선호도 마스크를 사용하여 내부 PlayFab Multiplayer 라이브러리 스레드를 특정 CPU 코어에 고정하는 PFMultiplayerSetThreadAffinityMask에 대한 참조입니다.

내부 멀티플레이어 라이브러리 스레드가 실행되는 프로세서를 선택적으로 구성합니다.

## 구문

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

### 매개 변수

**`threadId`**   [PFMultiplayerThreadId](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid.md)

프로세서 선호도를 구성할 내부 멀티플레이어 라이브러리 스레드의 유형입니다.

**`threadAffinityMask`**   uint64\_t

이 유형의 멀티플레이어 라이브러리 스레드에 대한 선호도 마스크입니다.

### 반환 값

형식: HRESULT

호출에 성공한 경우 `S_OK`이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md)를 통해 검색할 수 있습니다.

## 설명

이 메서드는 타이틀이 지정된 유형의 내부 멀티플레이어 라이브러리 스레드에 대한 프로세서 선호도를 구성할 수 있게 합니다. \
\
 이 메서드는 [PFMultiplayerInitialize()](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md) 전후 언제든지 호출할 수 있으며 즉시 적용됩니다. 스레드 프로세서 설정은 [PFMultiplayerUninitialize()](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md) 및 PFMultiplayerInitialize() 호출 간에 유지됩니다. 64개 이상의 코어가 있는 경우 이 메서드는 항상 프로세서 그룹 0에 적용됩니다.   \
\
 임의의 프로세서를 지정하려면 `threadAffinityMask` 매개 변수로 `PFMultiplayerAnyProcessor`를 전달합니다. 이는 이 메서드가 호출되지 않은 경우 멀티플레이어 라이브러리가 사용할 기본값이기도 합니다.

## 요구 사항

**헤더:** PFMultiplayer.h

## 함께 보기

[PFMultiplayer members](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)\
[PFMultiplayerThreadId](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid.md)


## Related topics

- [PFMultiplayerThreadId](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/enums/pfmultiplayerthreadid.md)
- [PFMultiplayerInitialize](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [비동기 Lobby 및 Matchmaking C++ SDK 작업 가이드](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [PFMultiplayer C/C++ API 개요 - PFMultiplayer.h](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)
- [set_thread_affinity_mask](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)