struttura DD_GETD3DQUERYDATA (d3dhal.h)

Articolo
02/06/2025

Solo DirectX 9.0 e versioni successive.

DD_GETD3DQUERYDATA è la struttura dei dati a cui punta il campo lpvData di DD_GETDRIVERINFODATA per le query di DD_GETDRIVERINFO2DATA con il tipo D3DGDI2_TYPE_GETD3DQUERY.

Sintassi

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

Membri

gdi2

Specifica una struttura DD_GETDRIVERINFO2DATA che contiene i dati di GetDriverInfo2.

dwQueryIndex

Specifica l'indice del tipo di query da restituire.

QueryType

Riceve un valore dall'enumerazione D3DQUERYTYPE che specifica la funzionalità di query effettiva.

Osservazioni

Il runtime identifica il tipo di query da restituire con un indice integer il cui valore varia tra zero e uno minore del numero di tipi di query supportati segnalati in precedenza dal driver in una query D3DGDI2_TYPE_GETD3DQUERYCOUNT. Il mapping di questi indici ai tipi di query effettivi viene lasciato al driver. Tuttavia, ogni indice deve essere mappato in modo univoco a un tipo di query supportato. L'ordine in cui vengono segnalati i tipi di query non è significativo.

Durante l'elaborazione di questa GetDriverInfo2 richiedere al driver di leggere il valore nell'unione come se fosse il membro dwQueryIndex ed eseguirne il mapping a uno dei tipi di query supportati (probabilmente usando il valore in dwQueryIndex come indice in una matrice di valori D3DQUERYTYPE). Il driver deve quindi copiare il tipo di query nell'unione come se fosse il membro QueryType. Il runtime garantisce che passi solo un indice al driver compreso nell'intervallo zero a uno minore del numero di tipi di query segnalati dal driver. L'intervallo dell'indice deve essere convalidato nella compilazione del driver di debug.

Per altre informazioni sulle D3DQUERYTYPE, vedere la documentazione di DirectX SDK.