estrutura DD_HALINFO (ddrawint.h)

Artigo
08/23/2023

A estrutura DD_HALINFO descreve os recursos do hardware e do driver.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura DD_HALINFO.

vmiData

Especifica uma estrutura VIDEOMEMORYINFO que descreve a memória da exibição.

ddCaps

Especifica uma estrutura DDNTCORECAPS que contém recursos específicos do driver.

GetDriverInfo

Aponta para a função DdGetDriverInfo do driver. Essa função é chamada para obter mais informações sobre o driver do Microsoft DirectDraw. Esse membro pode ser NULL.

dwFlags

Especifica os sinalizadores de criação do driver de exibição. Esse membro é um OR bit a bit de qualquer um dos seguintes valores:

Sinalizador	Significado
DDHALINFO_ISPRIMARYDISPLAY	O driver é o driver de exibição principal.
DDHALINFO_MODEXILLEGAL	Esse hardware não dá suporte a modos ModeX.
DDHALINFO_GETDRIVERINFOSET	O membro GetDriverInfo está definido.
DDHALINFO_GETDRIVERINFO2	O driver dá suporte à variante GetDriverInfo2 de GetDriverInfo.

lpD3DGlobalDriverData

Aponta para uma estrutura de D3DHAL_GLOBALDRIVERDATA que descreve os recursos 3D do driver e seu dispositivo.

lpD3DHALCallbacks

Aponta para a estrutura de D3DHAL_CALLBACKS inicializada do driver.

lpD3DBufCallbacks

Usado apenas por drivers que desejam implementar a alocação de buffer de comando e vértice no nível do driver. Isso geralmente é feito por motivos de desempenho. O membro lpD3DBufCallbacks é um ponteiro para uma estrutura DD_D3DBUFCALLBACKS que o driver preenche com os retornos de chamada usados para dar suporte a buffers de comando e vértice gerenciados pelo driver. Esse membro normalmente deve ser ignorado pelo driver.

Comentários

A GDI aloca e inicializa zero a estrutura DD_HALINFO e a passa para a rotina DrvGetDirectDrawInfo do driver a ser inicializada com dados específicos do driver.