PFND3DDDI_QUERYDLISTFORAPPLICATION2 fonction de rappel (d3dumddi.h)

Article
02/23/2024

La fonction de rappel PFND3DDDI_QUERYDLISTFORAPPLICATION2 interroge dList pour une application.

Syntaxe

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

Paramètres

[out] unnamedParam1

Pointeur vers une valeur D3DDDI_DLIST_QUERY_RESULT qui décrit la préférence GPU retournée pour l’application interrogée.

[out] unnamedParam2

Pointeur vers une valeur D3DDDI_DLIST_QUERY_DECISION_FACTOR qui décrit le facteur qui a déterminé la préférence GPU retournée.

[in] unnamedParam3

Handle de l’objet de carte graphique. Ce handle est passé à la fonction de rappel pfnEscapeCb pointée vers unnamedParam4.

[in] unnamedParam4

Pointeur vers une fonction de rappel pfnEscapeCb qui partage des informations avec le pilote miniport d’affichage.

Valeur retournée

Retourne S_OK ou un résultat d’erreur approprié si l’opération échoue.

Remarques

À compter de WDDM 2.9, les pilotes doivent prendre en charge PFND3DDDI_QUERYDLISTFORAPPLICATION2 au lieu de PFND3DDDI_QUERYDLISTFORAPPLICATION1.

La fonction de rappel PFND3DDDI_QUERYDLISTFORAPPLICATION2 est appelée par le runtime graphique en mode utilisateur (DXGI) pendant l’initialisation de Microsoft Direct3D sur un système hybride pour déterminer le GPU sur lequel une application doit s’exécuter. Une liste dList est une liste d’applications qui ont besoin de surfaces partagées inter-adaptateurs pour un rendu hautes performances sur le GPU discret.

Les D3DDDI_DLIST_QUERY_RESULT et D3DDDI_DLIST_QUERY_DECISION_FACTOR retournés dans cette DDI aident le runtime à garantir et à améliorer la qualité des mises à jour de contenu DxDb, en évaluant le risque de régressions d’application pour une mise à jour.

Les pilotes système hybrides doivent configurer et inscrire une DLL dList qui exporte cette fonction. Pour plus d’informations sur les systèmes hybrides, consultez Utilisation de ressources inter-adaptateurs dans un système hybride.