DD_GETFORMATDATA struttura (d3dhal.h)

DirectX 8.0 e versioni successive solo.

DD_GETFORMATDATA è la struttura di dati a cui fa riferimento il campo lpvData di DD_GETDRIVERINFODATA per le query DD_GETDRIVERINFO2DATA con il tipo D3DGDI2_TYPE_GETFORMAT.

Sintassi

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Members

gdi2

Specifica una struttura DD_GETDRIVERINFO2DATA contenente i dati GetDriverInfo2 .

dwFormatIndex

Specifica l'indice del formato pixel da restituire.

format

Riceve il formato pixel effettivo in una struttura DDPIXELFORMAT .

Commenti

Il runtime identifica il formato da restituire con un indice integer il cui valore varia tra zero e uno inferiore al numero di formati supportati segnalati in precedenza dal driver. Il mapping di questi indici ai formati effettivi viene lasciato al driver. Tuttavia, ogni indice deve eseguire il mapping univoco a un formato supportato. L'ordine in cui vengono segnalati i formati non è significativo.

Quando si elabora questa richiesta GetDriverInfo2 , il driver deve leggere dwFormatIndex e eseguire il mapping a uno dei formati supportati (probabilmente usando dwFormatIndex come indice in una matrice di strutture DDPIXELFORMAT) e quindi copiare tale formato nel campo formato del campo DD_GETFORMATDATA. Il runtime garantisce che passi solo un indice al driver che si trova nell'intervallo zero a uno inferiore al numero di formati di superficie segnalati dal driver. L'intervallo dell'indice deve essere convalidato nella compilazione del driver di debug.

DirectX 9.0 e versioni successive solo.In input, la versione del runtime DirectX usata dall'applicazione viene specificata nel membro dwSize della struttura DDPIXELFORMAT in formato. Questo membro dwSize è impostato su DD_RUNTIME_VERSION, che è 0x00000900 per DirectX 9.0.

Requisiti

Requisito Valore
Intestazione d3dhal.h (include D3dhal.h)

Vedi anche

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA