struttura DD_GETDRIVERSTATEDATA (ddrawint.h)

Articolo
08/23/2023

La struttura DD_GETDRIVERSTATEDATA descrive lo stato del driver.

Sintassi

typedef struct _DD_GETDRIVERSTATEDATA {
  DWORD   dwFlags;
  union {
    PDD_DIRECTDRAW_GLOBAL lpDD;
    DWORD_PTR             dwhContext;
  };
  LPDWORD lpdwStates;
  DWORD   dwLength;
  HRESULT ddRVal;
} *PDD_GETDRIVERSTATEDATA, DD_GETDRIVERSTATEDATA;

Members

dwFlags

Specifica il set di flag per indicare i dati richiesti. Questo parametro può essere impostato su uno dei flag seguenti:

Flag	Significato
D3DDEVINFOID_D3DTEXTUREMANAGER	Richiede informazioni sulla gestione delle trame eseguite dal runtime Direct3D in una struttura di D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTUREMANAGER	Richiede informazioni sulla gestione delle trame eseguite dal driver o dal runtime Direct3D in una struttura D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Richiede informazioni sull'attività trama dell'applicazione in una struttura D3DDEVINFO_TEXTURING.
D3DDEVINFOID_VCACHE	Solo versioni directX 8.1 Richiede informazioni sui vertici della cache in una struttura D3DDEVINFO_VCACHE.

lpDD

Punta a una struttura DD_DIRECTDRAW_GLOBAL che descrive il dispositivo.

dwhContext

Specifica l'ID del contesto per cui vengono richieste le informazioni.

lpdwStates

Punta ai dati sullo stato del driver Direct3D da compilare dal driver. Se, ad esempio, D3DDEVINFOID_VCACHE viene specificato nel membro dwFlags , il driver punta il membro lpdwStates a una struttura D3DDEVINFO_VCACHE che contiene informazioni sui vertici della cache.

dwLength

Specifica la lunghezza, in byte, dei dati sullo stato da compilare dal driver.

ddRVal

Specifica il percorso in cui il driver scrive il valore restituito del callback D3dGetDriverState . Un codice restituito di D3D_OK indica l'esito positivo. Per altre informazioni, vedere Codici restituiti per i callback del driver Direct3D.

Commenti

Le applicazioni possono usare il metodo IDirect3DDevice7::GetInfo e specificare i flag D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER e D3DDEVINFOID_TEXTURING per recuperare le informazioni di texturing. Per altre informazioni su questo metodo e sulle strutture correlate a questi flag, vedere la documentazione di DirectX SDK. Il runtime passa quindi questi flag al driver.

Solo versioni DirectX 8.1.Il runtime Direct3D specifica il flag D3DDEVINFOID_VCACHE nel membro dwFlags per recuperare le informazioni sulla cache dei vertici dal driver specificato nel membro lpDD . Il driver specifica queste informazioni in una struttura D3DDEVINFO_VCACHE e la restituisce nel membro lpdwStates .

Solo DirectX 9.0 e versioni successive. Il runtime Direct3D esegue una query asincrona sul driver per le informazioni sui vertici della cache usando i comandi D3DDP2OP_CREATEQUERY e D3DDP2OP_ISSUEQUERY e il tipo di query D3DQUERYTYPE_VCACHE nelle chiamate al callback D3dDrawPrimitives2 del driver. Per altre informazioni, vedere D3DDEVINFO_VCACHE.

Nota Il flag D3DDEVINFOID_VCACHE è definito in d3dhal.h; Gli altri flag che possono essere impostati in dwFlags sono definiti in d3dtypes.h.