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

# get_thread_affinity_mask

> chat_manager::get_thread_affinity_mask

Retrieves the current affinity mask representing the processor(s) on which internal Game Chat threads will run or are running.

## Syntax

```cpp theme={null}
void get_thread_affinity_mask(  
    game_chat_thread_id threadId,  
    uint64_t* affinityMask  
)  
```

### Parameters

*threadId*   \_In\_\
Type: [game\_chat\_thread\_id](https://docs.xbox.com/reference/chat/gamechat2/enums/game_chat_thread_id.md)

The type of internal Game Chat thread for which processor affinity should be retrieved.\
The internal thread to retrieve the processor mask for.

*affinityMask*   \_Out\_\
Type: uint64\_t

A place to store the affinity mask representing the processor(s) on which the internal Game Chat threads will run or are running.

### Return value

Type: void

## Remarks

This retrieves the current processor affinity for internal Game Chat threads of a given type.

This method does not require chat\_manager::initialize() to have been called first.

A reported value of `c_anyProcessor` written to *affinityMask* indicates that the thread is free to run on any processor.

> [!NOTE]
>
> `c_anyProcessor` is a `constexpr uint64_t` with a value of 0xFFFFFFFFFFFFFFFF.

## Requirements

**Header:** GameChat2.h

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

[chat\_manager](https://docs.xbox.com/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)\
[game\_chat\_thread\_id](https://docs.xbox.com/reference/chat/gamechat2/enums/game_chat_thread_id.md)\
[chat\_manager::set\_thread\_affinity\_mask](https://docs.xbox.com/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)


## Related topics

- [set_thread_affinity_mask](https://docs.xbox.com/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)
- [get_thread_processor](https://docs.xbox.com/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_processor.md)
- [PartyManager::GetThreadAffinityMask](https://docs.xbox.com/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getthreadaffinitymask.md)
- [PartyXblManager::GetThreadAffinityMask](https://docs.xbox.com/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getthreadaffinitymask.md)
- [PartyManager::SetThreadAffinityMask](https://docs.xbox.com/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setthreadaffinitymask.md)