PFND3DDDI_QUERYDLISTFORAPPLICATION2 callback function (d3dumddi.h)

Article
11/03/2021

The PFND3DDDI_QUERYDLISTFORAPPLICATION2 callback function queries the dList for an application.

Syntax

PFND3DDDI_QUERYDLISTFORAPPLICATION2 Pfnd3dddiQuerydlistforapplication2;

HRESULT Pfnd3dddiQuerydlistforapplication2(
  [out] D3DDDI_DLIST_QUERY_RESULT *unnamedParam1,
  [out] D3DDDI_DLIST_QUERY_DECISION_FACTOR *unnamedParam2,
  [in]  HANDLE unnamedParam3,
  [in]  PFND3DDDI_ESCAPECB unnamedParam4
)
{...}

Parameters

[out] unnamedParam1

Pointer to a D3DDDI_DLIST_QUERY_RESULT value that describes the returned GPU preference for the queried application.

[out] unnamedParam2

Pointer to a D3DDDI_DLIST_QUERY_DECISION_FACTOR value that describes the factor that determined the returned GPU preference.

[in] unnamedParam3

A handle to the graphics adapter object. This handle is passed to the pfnEscapeCb callback function pointed to by unnamedParam4.

[in] unnamedParam4

Pointer to a pfnEscapeCb callback function that shares info with the display miniport driver.

Return value

Returns S_OK, or an appropriate error result if the operation is not successful.

Remarks

Starting with WDDM 2.9, drivers must support PFND3DDDI_QUERYDLISTFORAPPLICATION2 instead of PFND3DDDI_QUERYDLISTFORAPPLICATION1.

The PFND3DDDI_QUERYDLISTFORAPPLICATION2 callback function is called by the user-mode graphics runtime (DXGI) during Microsoft Direct3D initialization on a hybrid system to determine which GPU an application should run on. A dList is a list of applications that need cross-adapter shared surfaces for high-performance rendering on the discrete GPU.

The D3DDDI_DLIST_QUERY_RESULT and D3DDDI_DLIST_QUERY_DECISION_FACTOR returned in this DDI help the runtime to ensure and improve the quality of DxDb content updates, by assessing for risk of application regressions for an update.

Hybrid system drivers need to set up and register a dList DLL that exports this function. For more information on hybrid systems, see Using cross-adapter resources in a hybrid system.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2022
Header	d3dumddi.h