PFND3DDDI_QUERYDLISTFORAPPLICATION2 callback function (d3dumddi.h)
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 |