PFND3DDDI_QUERYDLISTFORAPPLICATION1 callback function (d3dumddi.h)

The PFND3DDDI_QUERYDLISTFORAPPLICATION1 function queries a dList for an application.

Syntax

PFND3DDDI_QUERYDLISTFORAPPLICATION1 Pfnd3dddiQuerydlistforapplication1;

HRESULT Pfnd3dddiQuerydlistforapplication1(
  [out] BOOL *unnamedParam1,
  [in]  HANDLE unnamedParam2,
  [in]  PFND3DDDI_ESCAPECB unnamedParam3
)
{...}

Parameters

[out] unnamedParam1

If TRUE, the application should be run on the discrete GPU. Otherwise, the application should run on the integrated GPU.

[in] unnamedParam2

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

[in] unnamedParam3

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.

In WDDM versions prior to WDDM 2.9, PFND3DDDI_QUERYDLISTFORAPPLICATION1 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.

For more information on how to call this function and set up the DLL that exports it, see Hybrid system DDI.

For more general information on hybrid systems, see Using cross-adapter resources in a hybrid system.

Requirements

See also

PFND3DDDI_QUERYDLISTFORAPPLICATION2

pfnEscapeCb