structure DD_HALINFO (ddrawint.h)

Article
08/23/2023

La structure DD_HALINFO décrit les fonctionnalités du matériel et du pilote.

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure DD_HALINFO.

vmiData

Spécifie une structure VIDEOMEMORYINFO qui décrit la mémoire de l’affichage.

ddCaps

Spécifie une structure DDNTCORECAPS qui contient des fonctionnalités spécifiques au pilote.

GetDriverInfo

Pointe vers la fonction DdGetDriverInfo du pilote. Cette fonction est appelée pour obtenir d’autres informations sur le pilote Microsoft DirectDraw. Ce membre peut être NULL.

dwFlags

Spécifie les indicateurs de création du pilote d’affichage. Ce membre est un or au niveau du bit de l’une des valeurs suivantes :

Indicateur	Signification
DDHALINFO_ISPRIMARYDISPLAY	Le pilote est le pilote d’affichage principal.
DDHALINFO_MODEXILLEGAL	Ce matériel ne prend pas en charge les modes ModeX.
DDHALINFO_GETDRIVERINFOSET	Le membre GetDriverInfo est défini.
DDHALINFO_GETDRIVERINFO2	Le pilote prend en charge la variante GetDriverInfo2 de GetDriverInfo.

lpD3DGlobalDriverData

Pointe vers une structure D3DHAL_GLOBALDRIVERDATA qui décrit les fonctionnalités 3D du pilote et de son périphérique.

lpD3DHALCallbacks

Pointe vers la structure D3DHAL_CALLBACKS initialisée du pilote.

lpD3DBufCallbacks

Utilisé uniquement par les pilotes qui souhaitent implémenter l’allocation du vertex au niveau du pilote et de la mémoire tampon de commande. Cette opération est généralement effectuée pour des raisons de performances. Le membre lpD3DBufCallbacks est un pointeur vers une structure de DD_D3DBUFCALLBACKS que le pilote remplit avec les rappels utilisés pour prendre en charge les tampons de vertex et de commande gérés par le pilote. Ce membre doit normalement être ignoré par le pilote.

Notes

GDI alloue et initialise zéro la structure DD_HALINFO et la transmet à la routine DrvGetDirectDrawInfo du pilote pour l’initialiser avec des données spécifiques au pilote.