struttura DD_GETD3DQUERYDATA (d3dhal.h)

Articolo
02/23/2024

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 DD_GETDRIVERINFO2DATA con il tipo D3DGDI2_TYPE_GETD3DQUERY.

Sintassi

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

Members

gdi2

Specifica una struttura DD_GETDRIVERINFO2DATA che contiene i dati 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.

Commenti

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 di D3DGDI2_TYPE_GETD3DQUERYCOUNT. Il mapping di questi indici ai tipi di query effettivi viene lasciato al driver. Tuttavia, ogni indice deve eseguire il mapping univoco a un tipo di query supportato. L'ordine in cui vengono segnalati i tipi di query non è significativo.

Quando si elabora questa richiesta GetDriverInfo2 , il driver deve leggere il valore nell'unione come se fosse il membro dwQueryIndex ed eseguire il mapping di tale valore 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 inferiore al 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.