Windows Dev Center

IDXGIDevice::SetGPUThreadPriority method

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.

Windows Phone 8: This API is supported.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIDevice
DXGI Interfaces
IDXGIDevice::GetGPUThreadPriority

 

 

Community Additions

ADD
Show:
© 2015 Microsoft