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

See also

ID3D12Device