Função DrvGetDirectDrawInfo (winddi.h)

Artigo
03/04/2024

A função DrvGetDirectDrawInfo retorna os recursos do hardware gráfico.

Sintaxe

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Parâmetros

dhpdev

Identificador para o PDEV retornado pela rotina DrvEnablePDEV do driver.

pHalInfo

Aponta para uma estrutura de DD_HALINFO na qual o driver deve retornar os recursos de hardware aos quais ele dá suporte.

pdwNumHeaps

Aponta para o local em que o driver deve retornar o número de estruturas VIDEOMEMORY apontadas por pvmList.

pvmList

Aponta para uma matriz de estruturas VIDEOMEMORY nas quais o driver deve retornar informações sobre cada parte de memória de exibição que ele controla. O driver deve ignorar esse parâmetro quando for NULL.

pdwNumFourCCCodes

Aponta para o local em que o driver deve retornar o número de DWORDs apontados por pdwFourCC.

pdwFourCC

Aponta para uma matriz de DWORDs na qual o driver deve retornar informações sobre cada FOURCC compatível. O driver deve ignorar esse parâmetro quando for NULL.

Retornar valor

DrvGetDirectDrawInfo retornará TRUE se for bem-sucedido; caso contrário, retornará FALSE.

Comentários

A rotina DrvGetDirectDrawInfo do driver deve fazer o seguinte:

Quando pvmList e pdwFourCC são NULL:
1. Reserve memória de exibição fora da tela para uso do DirectDraw.
2. Escreva o número de heaps de memória de exibição de driver e FOURCCs com suporte em pdwNumHeaps e pdwNumFourCC, respectivamente.
Quando pvmList e pdwFourCC não são NULL:
1. Escreva o número de heaps de memória de exibição de driver e FOURCCs com suporte em pdwNumHeaps e pdwNumFourCC, respectivamente.
2. Para cada estrutura VIDEOMEMORY na lista à qual pvmList aponta, preencha os membros apropriados para descrever uma parte específica da memória de exibição. A lista de estruturas fornece ao DirectDraw uma descrição completa da memória offscreen do driver.
Inicialize os membros da estrutura DD_HALINFO com informações específicas do driver da seguinte maneira:
1. Inicialize os membros apropriados da estrutura VIDEOMEMORYINFO no vmiData para descrever as características gerais da memória da exibição.
2. Inicialize os membros apropriados da estrutura DDCORECAPS no ddCaps para descrever os recursos do hardware.
3. Se o driver implementar uma função DdGetDriverInfo , defina GetDriverInfo para apontar para ela e defina dwFlags como DDHALINFO_GETDRIVERINFOSET.