PFN_IDDCXSETREALTIMEGPUPRIORITY callback function (iddcx.h)

PFN_IDDCXSETREALTIMEGPUPRIORITY is a pointer to an OS callback function through which to raise the GPU priority of a DirectX device to realtime.

Syntax

PFN_IDDCXSETREALTIMEGPUPRIORITY PfnIddcxsetrealtimegpupriority;

HRESULT * PfnIddcxsetrealtimegpupriority(
  [in] PIDD_DRIVER_GLOBALS DriverGlobals,
  [in] IDDCX_SWAPCHAIN SwapChainObject,
  [in] const IDARG_IN_SETREALTIMEGPUPRIORITY *pIn
)
{...}

Parameters

[in] DriverGlobals

Pointer to an IDD_DRIVER_GLOBALS structure containing system-defined per-driver data.

[in] SwapChainObject

An IDDCX_SWAPCHAIN object that represents the swapchain the provided DXGI device will process.

[in] pIn

Pointer to a IDARG_IN_SETREALTIMEGPUPRIORITY structure with additional input arguments about the DXGI device.

Return value

If the routine succeeds it return S_OK. 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.

Remarks

An indirect display driver (IDD) should not use this pointer to directly call the function that it points to. IDDs should instead call IddCxSetRealtimeGPUPriority.

Setting realtime priority is not supported on WDDM 1.x devices; IddCxSetRealtimeGPUPriority will return E_NOTIMPL for such devices.

Requirements

Requirement Value
Minimum supported client Windows 10, version 22H2
Header iddcx.h

See also

IddCxSetRealtimeGPUPriority