DD_HALINFO struttura (ddrawint.h)

Articolo
08/23/2023

La struttura DD_HALINFO descrive le funzionalità dell'hardware e del driver.

Sintassi

typedef struct _DD_HALINFO {
  DWORD               dwSize;
  VIDEOMEMORYINFO     vmiData;
  DDNTCORECAPS        ddCaps;
  PDD_GETDRIVERINFO   GetDriverInfo;
  DWORD               dwFlags;
  LPVOID              lpD3DGlobalDriverData;
  LPVOID              lpD3DHALCallbacks;
  PDD_D3DBUFCALLBACKS lpD3DBufCallbacks;
} DD_HALINFO, *PDD_HALINFO;

Members

dwSize

Specifica le dimensioni in byte di questa struttura DD_HALINFO.

vmiData

Specifica una struttura VIDEOMEMORYINFO che descrive la memoria del display.

ddCaps

Specifica una struttura DDNTCORECAPS che contiene funzionalità specifiche del driver.

GetDriverInfo

Punta alla funzione DdGetDriverInfo del driver. Questa funzione viene chiamata per ottenere ulteriori informazioni sul driver Microsoft DirectDraw. Questo membro può essere NULL.

dwFlags

Specifica i flag di creazione del driver di visualizzazione. Questo membro è un OR bit per bit di uno dei valori seguenti:

Flag	Significato
DDHALINFO_ISPRIMARYDISPLAY	Il driver è il driver di visualizzazione primario.
DDHALINFO_MODEXILLEGAL	Questo hardware non supporta le modalità ModeX.
DDHALINFO_GETDRIVERINFOSET	Il membro GetDriverInfo è impostato.
DDHALINFO_GETDRIVERINFO2	Driver supporta la variante GetDriverInfo2 di GetDriverInfo.

lpD3DGlobalDriverData

Punta a una struttura D3DHAL_GLOBALDRIVERDATA che descrive le funzionalità 3D del driver e del relativo dispositivo.

lpD3DHALCallbacks

Punta alla struttura di D3DHAL_CALLBACKS inizializzata del driver.

lpD3DBufCallbacks

Usato solo dai driver che vogliono implementare il vertice a livello di driver e l'allocazione del buffer dei comandi. Questa operazione viene in genere eseguita per motivi di prestazioni. Il membro lpD3DBufCallbacks è un puntatore a una struttura DD_D3DBUFCALLBACKS che il driver compila con i callback usati per supportare i vertici e i buffer dei comandi gestiti dal driver. Questo membro deve normalmente essere ignorato dal driver.

Commenti

GDI alloca e inizializza la struttura di DD_HALINFO e la passa alla routine DrvGetDirectDrawInfo del driver da inizializzare con dati specifici del driver.