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

# SetCpuAffinity

> IDStorageFactoryX::SetCpuAffinity

# IDStorageFactoryX::SetCpuAffinity

为 DirectStorage 设置 CPU 亲和性掩码。

## Syntax

```cpp theme={null}
HRESULT SetCpuAffinity(  
         UINT64 affinity  
)  
```

### Parameters

*affinity*\
类型：UINT64

CPU 亲和性掩码。

### Return value

类型：HRESULT

标准 HRESULT 错误代码。

## Remarks

DirectStorage 通常在调用方线程中执行工作。但是，某些工作无法在调用方线程中执行。若要将此类工作限制在指定的一组 CPU 内核上运行，请设置 CPU 亲和性掩码。

有关详细信息，请参阅 [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md) 中“IDStorageFileX”一节内的“SetCPUAffinity”。

## Requirements

**头文件：** dstorage\_xs.h

**库：** dstorage\_xs.lib

**受支持的平台：** XBOX Series 主机

## See also

[IDStorageFactoryX](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)\
[DStorage](https://docs.xbox.com/zh-CN/reference/system/dstorage/dstorage_members.md)


## Related topics

- [IDStorageFactoryX（接口内容）](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)
- [PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)
- [set_thread_affinity_mask](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)
- [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [get_thread_affinity_mask](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_affinity_mask.md)