DD_GETEXTENDEDMODEDATA struttura (d3dhal.h)

Articolo
03/08/2023

DirectX 9.0 e versioni successive solo.

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

Sintassi

typedef struct _DD_GETEXTENDEDMODEDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwModeIndex;
  D3DDISPLAYMODE        mode;
} DD_GETEXTENDEDMODEDATA;

Members

gdi2

Specifica una struttura DD_GETDRIVERINFO2DATA contenente i dati GetDriverInfo2 .

dwModeIndex

Specifica l'indice della modalità di visualizzazione da restituire.

mode

Riceve una struttura D3DDISPLAYMODE che specifica la modalità di visualizzazione effettiva.

Commenti

Il runtime identifica la modalità di visualizzazione da restituire con un indice intero il cui valore varia tra zero e uno inferiore al numero di modalità di visualizzazione supportate segnalate in precedenza dal driver in una query DD_GETDRIVERINFO2DATA con il tipo D3DGDI2_TYPE_GETEXTENDEDMODECOUNT. Il mapping di questi indici alle modalità di visualizzazione effettive viene lasciato al driver. Tuttavia, ogni indice deve eseguire il mapping univoco a una modalità di visualizzazione supportata. L'ordine in cui vengono segnalate le modalità di visualizzazione non è significativo.

Quando si elabora questa richiesta GetDriverInfo2 , il driver deve leggere il valore nel membro dwModeIndex e eseguire il mapping di tale valore a una delle modalità di visualizzazione supportate (probabilmente usando il valore in dwModeIndex come indice in una matrice di strutture di D3DDISPLAYMODE). Il driver deve quindi copiare la modalità di visualizzazione nel membro della modalità . Il runtime garantisce che passa solo un indice al driver che si trova nell'intervallo zero a uno inferiore al numero di modalità di visualizzazione segnalate dal driver. L'intervallo dell'indice deve essere convalidato nella compilazione del driver di debug.

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