IddCxSetRealtimeGPUPriority - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// iddcx.h
HRESULT IddCxSetRealtimeGPUPriority(
[in] IDDCX_SWAPCHAIN SwapChainObject,
[in] const IDARG_IN_SETREALTIMEGPUPRIORITY *pIn
);
View the official Windows Driver Kit DDI referenceNo description available.
An indirect display driver (IDD) calls IddCxSetRealtimeGPUPriority to raise the GPU priority of a DirectX device to realtime.
SwapChainObject [in]An IDDCX_SWAPCHAIN object that represents the swapchain the provided DXGI device will process.
pIn [in]Pointer to a IDARG_IN_SETREALTIMEGPUPRIORITY structure with additional input arguments about the DXGI device.
IddCxSetRealtimeGPUPriority returns STATUS_SUCCESS (S_OK) if the call succeeds. Otherwise, it returns an appropriate NTSTATUS error code such as the following.
| Error code | Meaning |
|---|---|
| E_INVALIDARG | An invalid swapchain object was provided. |
| E_NOTIMPL | The GPU priority boost is not supported. See Remarks. |
An IDD can call this function to ensure GPU work for processing a frame is completed in a timely manner.
On success the GPU priority for the provided DXGI device will be raised to realtime. This means any GPU work scheduled by this device will have higher priority than any regular application can set. The OS picks the exact realtime priority level to set; the chosen level in the realtime priority band might change in future OS releases.
Setting realtime priority is not supported on WDDM 1.x devices; IddCxSetRealtimeGPUPriority will return E_NOTIMPL for such devices.
IDARG_IN_SETREALTIMEGPUPRIORITY