IDXGIDevice::SetGPUThreadPriority Method

Sets the GPU thread priority.

Syntax

public:
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

Header: Declared in d3d11_x.h (dxgi.h on other Windows platforms).