Função DrvEnableDirectDraw (winddi.h)

Artigo
08/27/2023

A função DrvEnableDirectDraw habilita o hardware para uso do DirectDraw.

Sintaxe

BOOL DrvEnableDirectDraw(
  DHPDEV              dhpdev,
  DD_CALLBACKS        *pCallBacks,
  DD_SURFACECALLBACKS *pSurfaceCallBacks,
  DD_PALETTECALLBACKS *pPaletteCallBacks
);

Parâmetros

dhpdev

Identificador para o PDEV retornado pela rotina DrvEnablePDEV do driver.

pCallBacks

Aponta para a estrutura DD_CALLBACKS a ser inicializada pelo driver.

pSurfaceCallBacks

Aponta para a estrutura DD_SURFACECALLBACKS a ser inicializada pelo driver.

pPaletteCallBacks

Aponta para a estrutura DD_PALETTECALLBACKS a ser inicializada pelo driver.

Valor retornado

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

Comentários

A GDI chama a função DrvEnableDirectDraw do driver para obter ponteiros para os retornos de chamada do DirectDraw aos quais o driver dá suporte. O driver deve definir os membros do ponteiro de função de DD_CALLBACKS, DD_SURFACECALLBACKS e DD_PALETTECALLBACKS para apontar para as funções que ele implementa. Um driver também deve definir os campos de bits correspondentes nos membros dwFlags dessas estruturas para todos os retornos de chamada com suporte.

A implementação drvEnableDirectDraw de um driver também pode dedicar recursos de hardware, como memória de exibição para uso apenas pelo DirectDraw.