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

# SetStablePowerState

> 某些类型的性能分析和实验性原型设计的开发期辅助工具。

某些类型的性能分析和实验性原型设计的开发期辅助工具。

## 语法

```cpp theme={null}
HRESULT SetStablePowerState(
    BOOL Enable
)
```

### 参数

*Enable*\
类型：BOOL

指定用于打开或关闭稳定电源状态的 BOOL 值。

### 返回值

类型：HRESULT

此方法返回 [Direct3D 12 返回代码](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) 之一。

## 备注

此方法仅在应用程序开发期间有用。它使开发人员能够分析多个算法的 GPU 使用情况，而不会受到 [动态频率缩放](https://en.wikipedia.org/wiki/Dynamic_frequency_scaling) 的影响。

不要在已发布应用程序的正常执行中调用此方法。此方法仅在计算机处于 [开发人员模式](https://learn.microsoft.com/en-us/windows/uwp/get-started/enable-your-device-for-development) 时才有效。如果未启用开发人员模式，则会发生设备移除。相反，应响应默认关闭的、面向开发人员的开关调用此方法。响应命令行参数、配置文件、注册表项和开发人员控制台命令来调用它是合理的使用场景。

稳定的电源状态通常将 GPU 时钟速率固定在明显低于用户在正常应用程序负载下体验的较慢设置。这种时钟速率的降低会影响整个系统。需要低时钟速率来确保处理器不会耗尽功率、电流和热量限制。正常使用场景通常利用处理器动态超频的能力。通过在稳定电源状态下比较两种设计得出的任何结论都应通过实际使用场景的支持结果进行双重检查。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [动态电源状态(DPS)](/zh-CN/build/game-principles/sustainability/dynamic-power-states.md)
- [使用 PowerShell/API 部署构建](/zh-CN/services/playfab/multiplayer/servers/deploy-using-powershell-api.md)
- [演练:使用 PowerShell/API 部署构建](/zh-CN/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-api-powershell.md)
- [《战争机器：重装版》案例研究](/zh-CN/build/game-principles/sustainability/case-studies/case-studies-gears-of-war-reloaded.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)