PFND3DDDI_QUERYDLISTFORAPPLICATION2回调函数 (d3dumddi.h)

项目
02/23/2024

PFND3DDDI_QUERYDLISTFORAPPLICATION2回调函数查询应用程序的 dList。

语法

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
)
{...}

参数

[out] unnamedParam1

指向 D3DDDI_DLIST_QUERY_RESULT 值的指针，该值描述查询的应用程序返回的 GPU 首选项。

[out] unnamedParam2

指向 D3DDDI_DLIST_QUERY_DECISION_FACTOR 值的指针，该值描述确定返回的 GPU 首选项的因素。

[in] unnamedParam3

图形适配器对象的句柄。此句柄传递给 unnamedParam4 指向的 pfnEscapeCb 回调函数。

[in] unnamedParam4

指向与显示微型端口驱动程序共享信息的 pfnEscapeCb 回调函数的指针。

返回值

如果操作不成功，则返回 S_OK或相应的错误结果。

注解

从 WDDM 2.9 开始，驱动程序必须支持 PFND3DDDI_QUERYDLISTFORAPPLICATION2 而不是 PFND3DDDI_QUERYDLISTFORAPPLICATION1。

在混合系统上进行 Microsoft Direct3D 初始化期间，用户模式图形运行时 (DXGI) 调用 PFND3DDDI_QUERYDLISTFORAPPLICATION2 回调函数，以确定应用程序应在哪个 GPU 上运行。 dList 是一个应用程序列表，这些应用程序需要跨适配器共享图面，以便在离散 GPU 上实现高性能呈现。

此 DDI 中返回 的D3DDDI_DLIST_QUERY_RESULT 和 D3DDDI_DLIST_QUERY_DECISION_FACTOR 通过评估更新的应用程序回归风险，帮助运行时确保和改进 DxDb 内容更新的质量。

混合系统驱动程序需要设置和注册导出此函数的 dList DLL 。有关混合系统的详细信息，请参阅在混合系统中使用跨适配器资源。