ID3D12Device::SetStablePowerState method (d3d12.h)
A development-time aid for certain types of profiling and experimental prototyping.
Syntax
HRESULT SetStablePowerState(
BOOL Enable
);
Parameters
Enable
Type: BOOL
Specifies a BOOL that turns the stable power state on or off.
Return value
Type: HRESULT
This method returns one of the Direct3D 12 Return Codes.
Remarks
This method is only useful during the development of applications. It enables developers to profile GPU usage of multiple algorithms without experiencing artifacts from dynamic frequency scaling.
Do not call this method in normal execution for a shipped application. This method only works while the machine is in developer mode. If developer mode is not enabled, then device removal will occur. Instead, call this method in response to an off-by-default, developer-facing switch. Calling it in response to command line parameters, config files, registry keys, and developer console commands are reasonable usage scenarios.
A stable power state typically fixes GPU clock rates at a slower setting that is significantly lower than that experienced by users under normal application load. This reduction in clock rate affects the entire system. Slow clock rates are required to ensure processors don’t exhaust power, current, and thermal limits. Normal usage scenarios commonly leverage a processors ability to dynamically over-clock. Any conclusions made by comparing two designs under a stable power state should be double-checked with supporting results from real usage scenarios.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | d3d12.h |
Library | D3D12.lib |
DLL | D3D12.dll |