PFND3DDDI_QUERYDLISTFORAPPLICATION2 funzione di callback (d3dumddi.h)

Articolo
02/06/2025

La funzione di callback PFND3DDDI_QUERYDLISTFORAPPLICATION2 esegue una query su dList per un'applicazione.

Sintassi

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

Parametri

[out] unnamedParam1

Puntatore a un valore D3DDDI_DLIST_QUERY_RESULT che descrive la preferenza GPU restituita per l'applicazione su cui è stata eseguita la query.

[out] unnamedParam2

Puntatore a un valore D3DDDI_DLIST_QUERY_DECISION_FACTOR che descrive il fattore che ha determinato la preferenza GPU restituita.

[in] unnamedParam3

Handle per l'oggetto scheda grafica. Questo handle viene passato alla pfnEscapeCb funzione di callback a cui punta unnamedParam4.

[in] unnamedParam4

Puntatore a un pfnEscapeCb funzione di callback che condivide informazioni con il driver miniport di visualizzazione.

Valore restituito

Restituisce S_OKo un risultato di errore appropriato se l'operazione non riesce.

Osservazioni

A partire da WDDM 2.9, i driver devono supportare PFND3DDDI_QUERYDLISTFORAPPLICATION2 anziché PFND3DDDI_QUERYDLISTFORAPPLICATION1.

La funzione di callback PFND3DDDI_QUERYDLISTFORAPPLICATION2 viene chiamata dal runtime di grafica in modalità utente (DXGI) durante l'inizializzazione di Microsoft Direct3D in un sistema ibrido per determinare la GPU su cui deve essere eseguita un'applicazione. Un dList è un elenco di applicazioni che richiedono superfici condivise tra adattatori per il rendering ad alte prestazioni nella GPU discreta.

I D3DDDI_DLIST_QUERY_RESULT e i D3DDDI_DLIST_QUERY_DECISION_FACTOR restituiti in questa DDI aiutano il runtime a garantire e migliorare la qualità degli aggiornamenti del contenuto DxDb, valutando il rischio di regressioni dell'applicazione per un aggiornamento.

I driver di sistema ibridi devono configurare e registrare una DLL dList che esporta questa funzione. Per altre informazioni sui sistemi ibridi, vedere Uso di risorse tra adattatori in un sistema ibrido.