IDXGIDevice::SetGPUThreadPriority method (dxgi.h)

Sets the GPU thread priority.

Syntax

HRESULT SetGPUThreadPriority(
  INT Priority
);

Parameters

Priority

Type: INT

A value that specifies the required GPU thread priority. This value must be between -7 and 7, inclusive, where 0 represents normal priority.

Return value

Type: HRESULT

Return S_OK if successful; otherwise, returns E_INVALIDARG if the Priority parameter is invalid.

Remarks

The values for the Priority parameter function as follows:

  • Positive values increase the likelihood that the GPU scheduler will grant GPU execution cycles to the device when rendering.
  • Negative values lessen the likelihood that the device will receive GPU execution cycles when devices compete for them.
  • The device is guaranteed to receive some GPU execution cycles at all settings.
To use the SetGPUThreadPriority method, you should have a comprehensive understanding of GPU scheduling. You should profile your application to ensure that it behaves as intended. If used inappropriately, the SetGPUThreadPriority method can impede rendering speed and result in a poor user experience.

Requirements

Requirement Value
Target Platform Windows
Header dxgi.h
Library DXGI.lib

See also

DXGI Interfaces

IDXGIDevice

IDXGIDevice::GetGPUThreadPriority